amigoer

Roster — Communication skill for Claude Code

Communication community

Desktop app that treats coding agents as contacts: a direct chat is a session, a group chat is an agent team.

How to install Roster

This entry records only its repository, not the path inside it, so there is no exact command to give. Open amigoer/roster and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Roster does

Desktop app that treats coding agents as contacts: a direct chat is a session, a group chat is an agent team. 把 code agent 当联系人用的桌面应用：单聊就是一次会话，拉个群就是一支 agent team。

Alternatives in Communication

Codepilot — A native desktop GUI for Claude Code — chat, code, and manage projects visually 4.3k ★
Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★
Claudix - Claude Code For VSCode — by Haleclipse - A VSCode extension that brings Claude Code directly into your editor with interactive chat int 1k ★

README

Roster

**English** | [简体中文](README.zh-CN.md)

Coding agents as contacts: a direct chat is a session, a group chat is an agent team.

Roster is a desktop app for the coding agents you already use: Claude Code, Codex, Gemini CLI and pi-agent. It does not write its own agent loop. It drives those agents, so model upgrades and prompt tuning keep coming from them, and gives them the shape of a chat app: conversations that persist, bots you set up once and reuse, groups where several agents work in the same repository, and one list that shows what needs you.

[!NOTE] Early development: there are no packaged releases yet, so run it from source. The interface is in Chinese for now.

Features

Bots are contacts. A bot keeps a name, avatar, preset prompt, agent, model and permission level. The same bot can join any number of conversations.
Groups are agent teams. Pick several bots and choose how turns pass: you lead with @mentions, a leader bot splits the task and assigns it, or every member answers each message while you decide. Members can talk at the same time; only one edits files at a time.
Your agents, detected. Agents already on your machine are used as they are. Missing ones are downloaded into Roster's own folder.
Subscription or API. A bot runs on the agent's own sign-in, or on a model API you add. Keys can come from environment variables; keys you save are encrypted with a key the operating system protects (Keychain on macOS).
Permission levels. Read-only, can write, or can execute. Anything beyond a bot's level becomes an approval card in the chat, never a blocking dialog.
What needs you comes first. Conversations waiting for an approval or a reply sort to the top, longest wait first. The desktop app adds notifications and a Dock badge.
One working directory per conversation, chosen when you start it. Attachments, slash commands and a context usage panel are built in.

Planned: a space (空间) that collects the docu