From cd55d9049fa3193229cad8686d1b457f2b6dcd84 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Tue, 27 Oct 2026 23:32:17 -0700 Subject: [PATCH 1/3] docs(readme): Claude Code on Linux answers @mentions (#2820 walked 10-28) 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 9f9a9f4298..f515360e63 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ commonly agent run --adapter claude 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. +- **Claude Code** answers @mentions on macOS and Linux. On Linux, run `commonly agent attach claude` and `commonly agent run` yourself (CLI 0.1.196 or later), because the page offers the MCP setup there. On 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`. - **OpenCode:** see the [OpenCode guide](docs/cli/opencode.md). From 2d2f1e62f7e711f4f20284e85abbae5378a3ff23 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 00:26:20 -0700 Subject: [PATCH 2/3] docs(readme): scope the Linux line to invite-only pods with bubblewrap; make commands runnable 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 f515360e63..2435548e4e 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ commonly agent run --adapter claude 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 and Linux. On Linux, run `commonly agent attach claude` and `commonly agent run` yourself (CLI 0.1.196 or later), because the page offers the MCP setup there. On 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. +- **Claude Code** answers @mentions on macOS. On Linux, it answers @mentions in invite-only pods, with bubblewrap installed (CLI 0.1.196 or later): run `commonly agent attach claude --pod --name ` and `commonly agent run ` yourself, because the page offers the MCP setup there. On 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`. - **OpenCode:** see the [OpenCode guide](docs/cli/opencode.md). From d845df724a18678e330f25c884eb1dcd998301b4 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Wed, 28 Oct 2026 00:34:47 -0700 Subject: [PATCH 3/3] docs(readme): Linux needs no env file; start from a project folder 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 2435548e4e..12f9aeb3e4 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ commonly agent run --adapter claude 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, it answers @mentions in invite-only pods, with bubblewrap installed (CLI 0.1.196 or later): run `commonly agent attach claude --pod --name ` and `commonly agent run ` yourself, because the page offers the MCP setup there. On 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. +- **Claude Code** answers @mentions on macOS. On Linux, it answers @mentions in invite-only pods, with bubblewrap installed (CLI 0.1.196 or later): from a project folder, run `commonly agent attach claude --pod --name ` and `commonly agent run ` yourself, because the page offers the MCP setup there. No environment file is needed. The CLI runs it inside bubblewrap on its own, and refuses to start if bubblewrap can't run. On 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`. - **OpenCode:** see the [OpenCode guide](docs/cli/opencode.md).