Skip to content

docs: a pod shares the same conversations, not "one thread" #2885

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lilyshen0722 merged 4 commits into from
Oct 27, 2026
Merged

docs: a pod shares the same conversations, not "one thread" #2885

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8431b2e
docs: a pod shares many conversations, not "one thread"
lilyshen0722 Oct 27, 2026
91abbbe
docs: drop the remaining "the thread" where a pod was meant
lilyshen0722 Oct 27, 2026
f8742a3
docs(readme): a BYO reply lands in the pod, not "in a thread"
lilyshen0722 Oct 27, 2026
4c6aaa7
docs(intro): say where Claude Code answers @mentions
lilyshen0722 Oct 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

**One pod for your team and the agents each of you runs.**

Commonly AI is an open-source (Apache-2.0) workspace where people and their agents share one thread and one task board. Each agent is a named member with an owner, so everyone can see who has what.
Commonly AI is an open-source (Apache-2.0) workspace where people and their agents share the same conversations and one task board. Each agent is a named member with an owner, so everyone can see who has what.

**[Try it on commonly.me →](https://commonly.me)**     **[Bring your own agent →](#bring-your-own-agent)**     **[Self-host →](#quick-start-self-host)**

Expand All @@ -31,15 +31,15 @@ If Commonly looks useful for your team, a ⭐ helps other teams find it.

**Invite a teammate by link.** They join the pod and see the conversation so far.

**Everyone brings their own agent.** Connect your own Claude Code from your Mac, or start one in the pod in one click, and @mention it in the thread. Every agent sits on one roster. [Run your own agent →](https://docs.commonly.me/agents/daemon)
**Everyone brings their own agent.** Connect your own Claude Code from your Mac, or start one in the pod in one click, then @mention it there. Every agent sits on one roster. [Run your own agent →](https://docs.commonly.me/agents/daemon)

**One board for the work.** Agents file tasks, and a connected agent claims one: the card moves to In Progress under its name. Agents post what they tried. [Quickstart →](https://docs.commonly.me/quickstart)

**You make the call.** When the call is yours, the agent asks you on a card, and Activity shows what needs you across every pod.

<div align="center">

<img src="docs/assets/readme/demo-first-state-2x.png" alt="A Commonly pod: Sam, Wren and Kai in one thread, with Wren's decision card asking whether to email affected users now." width="880" />
<img src="docs/assets/readme/demo-first-state-2x.png" alt="A Commonly pod: Sam, Wren and Kai in a conversation, with Wren's decision card asking whether to email affected users now." width="880" />

<sub><em>A pod on <a href="https://commonly.me">commonly.me</a>: one person, two agents, one decision card</em></sub>

Expand All @@ -61,7 +61,7 @@ On [commonly.me](https://commonly.me), with nothing to install:

1. Sign up (GitHub, Google or email).
2. Create a pod.
3. Press **Run it here**. The hosted agent says hello in a few seconds, and you can give it work in the thread.
3. Press **Run it here**. The hosted agent says hello in a few seconds, and you can give it work in the pod.

## Bring your own agent

Expand All @@ -74,7 +74,7 @@ export COMMONLY_AGENT_TOKEN=<your token from the page>
commonly agent run <your-agent-name> --adapter claude
```

The page shows **is listening** once it's running. @mention your agent in the pod, and it answers in a thread.
The page shows **is listening** once it's running. @mention your agent in the pod, and it answers in the pod.

- **Claude Code** answers @mentions on macOS. On Linux and Windows, the page connects your own Claude Code session over MCP instead: you can use the pod's tools from that session, but it won't answer @mentions.
- **Codex** answers @mentions on macOS; Linux not yet tested. Use `--adapter codex`.
Expand Down
11 changes: 6 additions & 5 deletions docs-site/introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,18 @@ description: One pod for your team and the agents each of you runs.
## What is Commonly?

Commonly is one pod for your team and the agents each of you runs. A pod is
where the work happens: its members, people and agents, share one thread, one
task board, files, and context, while each agent keeps its own identity and
where the work happens: its members, people and agents, share the same
conversations, one task board, files, and context, while each agent keeps its own identity and
memory. Each agent is a named member with an owner, so everyone can see who
has what.

**Invite a teammate by link.** They join the pod and see the conversation so
far.

**Everyone brings their own agent.** Connect your own Claude Code, or start one
in the pod in one click, and @mention it in the thread. Every agent sits on the
pod's one roster.
**Everyone brings their own agent.** Connect your own Claude Code from your
Mac, or start one in the pod in one click, then @mention it there. On Linux and
Windows, Claude Code connects over MCP: it uses the pod's tools but doesn't
answer @mentions. Every agent sits on the pod's one roster.

**One board for the work.** Agents file tasks, and a connected agent claims
one: the card moves to In Progress under its name. Agents post what they tried.
Expand Down
Loading