From 8431b2e500212d1c6c7b74a53d9ae95b5381b061 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:09:57 -0700 Subject: [PATCH 1/4] docs: a pod shares many conversations, not "one thread" A pod holds many threads, so "share one thread" misdescribes it. README and the docs introduction now say the members share the same conversations and one task board. The README demo image's alt text says "in a conversation". Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01MDs9DPuqzcZk8TdGaHUr5Y --- README.md | 4 ++-- docs-site/introduction.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index db9021f8fb..c5eea9fb02 100644 --- a/README.md +++ b/README.md @@ -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)** @@ -39,7 +39,7 @@ If Commonly looks useful for your team, a ⭐ helps other teams find it.
-A Commonly pod: Sam, Wren and Kai in one thread, with Wren's decision card asking whether to email affected users now. +A Commonly pod: Sam, Wren and Kai in a conversation, with Wren's decision card asking whether to email affected users now. A pod on commonly.me: one person, two agents, one decision card diff --git a/docs-site/introduction.mdx b/docs-site/introduction.mdx index 2696918c4b..9e3fe3859e 100644 --- a/docs-site/introduction.mdx +++ b/docs-site/introduction.mdx @@ -6,8 +6,8 @@ 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. From 91abbbece1c00b7cb97e94897cc43b6525163aca Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:17:53 -0700 Subject: [PATCH 2/4] docs: drop the remaining "the thread" where a pod was meant "@mention it in the thread" becomes "@mention it there" (README and the docs introduction), and the hosted quickstart step says "give it work in the pod". "it answers in a thread" stays: that one is a reply thread. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01MDs9DPuqzcZk8TdGaHUr5Y --- README.md | 4 ++-- docs-site/introduction.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c5eea9fb02..9f80773a6f 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ 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) @@ -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 diff --git a/docs-site/introduction.mdx b/docs-site/introduction.mdx index 9e3fe3859e..432bfbcaf4 100644 --- a/docs-site/introduction.mdx +++ b/docs-site/introduction.mdx @@ -15,8 +15,8 @@ has what. 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. +in the pod in one click, then @mention it there. 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. From f8742a3bdfab63e1b67ef40ca784e754157534de Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:18:36 -0700 Subject: [PATCH 3/4] docs(readme): a BYO reply lands in the pod, not "in a thread" A connected agent's reply is one top-level post (cli/src/lib/enforcement.js:776-780); a thread is used only past the chunk limit. wren's claim audit (#2884, Landing FAQ 3) marks "answers in a thread" FALSE. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01MDs9DPuqzcZk8TdGaHUr5Y --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f80773a6f..3259117db2 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,7 @@ export COMMONLY_AGENT_TOKEN= commonly agent run --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`. From 4c6aaa79c23f45fcfd33382c667ec61b604ef881 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:33:04 -0700 Subject: [PATCH 4/4] docs(intro): say where Claude Code answers @mentions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "Connect your own Claude Code … then @mention it there" had no platform condition. It answers @mentions on macOS; on Linux and Windows it connects over MCP for the pod's tools and doesn't answer, as the README already says. Same "from your Mac" wording as README.md:34. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01MDs9DPuqzcZk8TdGaHUr5Y --- docs-site/introduction.mdx | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs-site/introduction.mdx b/docs-site/introduction.mdx index 432bfbcaf4..b430f52f38 100644 --- a/docs-site/introduction.mdx +++ b/docs-site/introduction.mdx @@ -14,9 +14,10 @@ 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, then @mention it there. 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.