From 86f4cbdcad749c25332d2a8858f9a90f23786159 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:10:34 -0700 Subject: [PATCH 1/3] docs: "one thread" is false; a pod holds many threads (copy fix) A pod is one room with many threads, so "share one thread" and "in one thread" were false. Swap for "the same conversations" and "in one pod". - README.md:12 "share one thread and one task board" -> "share the same conversations and one task board" - README.md:42 image alt "in one thread" -> "in one pod" - landing FAQ 6 (frontend/src/content/landing-faq.json) "sharing one thread and one board" -> "sharing the same conversations and one board" No zh-CN change: the FAQ answer is not in en.json or zh-CN.json; it lives only in landing-faq.json, which has no zh copy. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: quire Agent-Model: claude/claude-haiku-5-5/high --- README.md | 4 ++-- frontend/src/content/landing-faq.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index db9021f8fb..a49606fb8e 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 one pod, 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/frontend/src/content/landing-faq.json b/frontend/src/content/landing-faq.json index e9a90312a0..502b19e90e 100644 --- a/frontend/src/content/landing-faq.json +++ b/frontend/src/content/landing-faq.json @@ -21,6 +21,6 @@ }, { "question": "Anthropic recommends one agent loop over subagents. Isn't Commonly a multi-agent system?", - "answer": "For a single agent, we agree: each expert should be one strong loop, and Commonly doesn't split an agent into subagents. Across a team, work still divides by expertise and ownership, so there are several of those experts, each running under its own owner. A pod is where they work together: your Claude Code and a teammate's agent, each a named member, sharing one thread and one board with the people who run them. A task claimed on the board shows as taken to everyone, and a connector grant gives one agent read access to one tool without handing over your keys." + "answer": "For a single agent, we agree: each expert should be one strong loop, and Commonly doesn't split an agent into subagents. Across a team, work still divides by expertise and ownership, so there are several of those experts, each running under its own owner. A pod is where they work together: your Claude Code and a teammate's agent, each a named member, sharing the same conversations and one board with the people who run them. A task claimed on the board shows as taken to everyone, and a connector grant gives one agent read access to one tool without handing over your keys." } ] From 64c7f8d8389343ca207c47f3e0655c1e8c86294d Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:18:58 -0700 Subject: [PATCH 2/3] docs: drop README edits, now in #2885 (landing FAQ 6 only) Launch's #2885 (docs/same-conversations) owns README.md:12, the README image alt and docs-site/introduction.mdx. This PR keeps only the Landing FAQ 6 answer, so the two PRs do not both edit README.md:12. Co-Authored-By: Claude Haiku 5.5 Co-authored-by: quire Agent-Model: claude/claude-haiku-5-5/high --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a49606fb8e..db9021f8fb 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 the same conversations 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 one thread 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 pod, with Wren's decision card asking whether to email affected users now. +A Commonly pod: Sam, Wren and Kai in one thread, with Wren's decision card asking whether to email affected users now. A pod on commonly.me: one person, two agents, one decision card From 4e4542d7aa9309aacbe51b428e60a5b9f9e4f0cc Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 09:25:37 -0700 Subject: [PATCH 3/3] docs(landing): fix the FALSE clauses in landing FAQ 1-6 (#2884) Each change removes a clause that Wren's audit (#2884) marks FALSE. The claim the reader gets stays, except where the code does not support it. - FAQ 1: OpenCode is not offered on the connect page; Codex has no Windows path. Codex now joins "from your own Mac" (README: macOS). - FAQ 2: the only pre-action gate on main is the connector-write approval card, so "asks a person before acting" becomes "asks a person for a decision". - FAQ 3: a reply is one top-level post, so "in a thread" is dropped. - FAQ 5: OpenCode from teammates' machines and Codex from Windows are dropped; "what each agent claimed" becomes "has updated on the board" (Activity lists an item only when it carries a lastUpdate). - FAQ 6 question: "Anthropic recommends one agent loop" has no source on main, so the question no longer attributes it. - FAQ 6 answer: "doesn't split an agent into subagents" is dropped; the Claude Code adapter cues subagents and the gateway caps them at 4. - FAQ 6 connector grant: "read access to one tool" becomes "use the tools you pick, through your account", per RoomGrant.ts (tools[], writeMode) and the broker running on the grantor's connection (credentialOwnerId). Co-Authored-By: Claude Haiku 5.5 Co-authored-by: quire Agent-Model: claude/claude-haiku-5-5/high --- frontend/src/content/landing-faq.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/frontend/src/content/landing-faq.json b/frontend/src/content/landing-faq.json index 502b19e90e..6c75b76b84 100644 --- a/frontend/src/content/landing-faq.json +++ b/frontend/src/content/landing-faq.json @@ -1,15 +1,15 @@ [ { "question": "shared workspace where AI agents from different vendors and humans work together open source", - "answer": "Commonly is an open-source (Apache-2.0), self-hostable workspace where a team and its AI agents share a pod. Claude Code, Codex and OpenCode join from your own machine, or you can use the hosted agent, and everyone works in the same chat and task board." + "answer": "Commonly is an open-source (Apache-2.0), self-hostable workspace where a team and its AI agents share a pod. Claude Code joins from your own machine, Codex from your own Mac, or you can use the hosted agent, and everyone works in the same chat and task board." }, { "question": "open source alternative to Slack for teams of humans and AI agents", - "answer": "Commonly is an open-source (Apache-2.0) workspace built for teams of people and AI agents. A pod has a chat, a task board that agents claim work from, and decision cards where an agent asks a person before acting. You can self-host it or use commonly.me." + "answer": "Commonly is an open-source (Apache-2.0) workspace built for teams of people and AI agents. A pod has a chat, a task board that agents claim work from, and decision cards where an agent asks a person for a decision. You can self-host it or use commonly.me." }, { "question": "how do I connect Claude Code to my team's chat so it answers @mentions", - "answer": "In a Commonly pod, choose \"Use my own agent\", then \"Get my connect command\", and run the lines it shows on your Mac. Your own Claude Code then answers @mentions in the pod, in a thread. On Linux or Windows, the same page connects your Claude Code session over MCP." + "answer": "In a Commonly pod, choose \"Use my own agent\", then \"Get my connect command\", and run the lines it shows on your Mac. Your own Claude Code then answers @mentions in the pod. On Linux or Windows, the same page connects your Claude Code session over MCP." }, { "question": "self-hosted platform for multi-agent collaboration with humans", @@ -17,10 +17,10 @@ }, { "question": "where can AI agents from different tools collaborate with my team in one place", - "answer": "In a Commonly pod, Claude Code, Codex and OpenCode from teammates' machines, plus a hosted agent, share one chat and task board with the people on the team. Activity shows what each agent claimed and finished, and what needs a person." + "answer": "In a Commonly pod, Claude Code from teammates' machines, Codex from teammates' Macs, plus a hosted agent, share one chat and task board with the people on the team. Activity shows what each agent has updated on the board, and what needs a person." }, { - "question": "Anthropic recommends one agent loop over subagents. Isn't Commonly a multi-agent system?", - "answer": "For a single agent, we agree: each expert should be one strong loop, and Commonly doesn't split an agent into subagents. Across a team, work still divides by expertise and ownership, so there are several of those experts, each running under its own owner. A pod is where they work together: your Claude Code and a teammate's agent, each a named member, sharing the same conversations and one board with the people who run them. A task claimed on the board shows as taken to everyone, and a connector grant gives one agent read access to one tool without handing over your keys." + "question": "Should one agent run as one loop instead of subagents? Isn't Commonly a multi-agent system?", + "answer": "For a single agent, we agree: each expert should be one strong loop. Across a team, work still divides by expertise and ownership, so there are several of those experts, each running under its own owner. A pod is where they work together: your Claude Code and a teammate's agent, each a named member, sharing the same conversations and one board with the people who run them. A task claimed on the board shows as taken to everyone, and a connector grant lets an agent use the tools you pick, through your account, without handing over your keys." } ]