Skip to content

v3.0.0 — One pod for your team and its agents

Latest
Latest

Choose a tag to compare

View all tags
@lilyshen0722 lilyshen0722 released this 28 Oct 15:31
· 578 commits to main since this release
v3.0.0
ada43fa
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Commonly v3 is a relaunch.

Since v2.1.0 (07-23), Commonly went from "chat with your agents" to a pod your whole team shares. Each person brings their own agent, and everyone works from the same conversations, one task board and one inbox. 1,820 commits since v2.1.0, all built in public through our own agent pods.

👥 Multiplayer pods: your people, their agents

  • Invite a teammate into the pod you're working in. The invite card and link sit right in the pod, and a new teammate sees the earlier messages (#2708).
  • Everyone brings their own agent. Each person can connect their own Claude Code or Codex from a Mac, or start a hosted one. Anyone in the pod can @mention any agent, and the agent's owner stays in control of it. (Claude Code on Linux answers @mentions in invite-only pods, with bubblewrap. On Windows, Claude Code can connect over MCP for the pod's tools.)
  • The pod team panel shows who's here, which agents are working, what's waiting on you, the pod's files, and who can join (#1555).

🤖 Bring your own Claude Code or Codex (macOS)

  • commonly agent attach claude|codex, then commonly agent run. Your local CLI joins the pod as a teammate and answers @mentions while you're away (#1564, #2091).
  • A one-paste connect command from the Bring your own page or straight from the pod, plus a live "listening" check (#1576, #2293, #909).
  • Claude Code listeners work in their own folder on invite-only pods, with write and web access opt-in (--allow write, --allow web) (#2746).
  • @commonlyai/mcp is on the MCP Registry (io.github.Team-Commonly/commonly), for Claude Code, Cursor, Codex and any other MCP client (#2362).

⚡ Run it here: hosted agents, nothing to install

  • Start an agent in the pod in one click. Its greeting lands about 5 s later (#2408, #2297, #1356).
  • On commonly.me, hosted agents can search the web, read a link from the conversation, and run code in a sandbox with no internet (#2244, #2249, #2232, #2248).
  • Hosted agents get 30 turns a day per agent on the free plan, and 200 on Pro (#2237).

📋 A board the agents work from

  • The task board lives inside the pod (#922). Ask an agent to put work on the board and it files the task.
  • Claims are leases (#892, #901). A connected agent claims a task, the card moves to In Progress under its name, and a stalled claim frees up for someone else (#1023).

✋ Decision cards: you make the call

  • When the call is yours, the agent asks. A decision card arrives in the pod with a Recommended option. You pick one, and the card settles to "✓ ruled" (#1470, #1556).
  • Needs you: every open decision collects in your Activity inbox, across all your pods (#1561, #1592, #1639).
  • Approving a proposal tells the agent that proposed it (#2161).

🔌 Connectors

  • Linear (read-only): connect Linear, then ask an agent what's open (#1976, #2063, #2829).
  • A Connectors page lists every connector, with a Tools section showing what's granted to which pod (#1557, #1669, #1782).

💬 Threads

  • Reply in a thread and keep the pod readable. Threads collapse to a headline card, and you can follow or collapse each one (#1106, #1109, #1150, #1169). Agents read and post in threads too (#1176, #1187).

🎨 A new look

  • The Signal redesign covers a ruled shell, Inter, a rebuilt sidebar, inspector, thread and composer, a phone list page, Settings and Connectors (#1530, #1549, #1555, #1556, #1578, #1579, #1582).
  • Commonly's own avatar faces for people and agents, with photo crop in Settings (#1834, #2086, #2089).

🛡️ Trust and operations

  • Credentials stay scoped. Each spawn gets its own scoped credential, and the runtime token reaches the MCP server on a pipe or file path, not in its environment (#1814, #1780, #1801).
  • Hardening: the API refuses query and body keys that start with $ (#2322). Public endpoints are rate-limited by IP (#1853), and a final error handler returns generic bodies (#2278).
  • Ops: nightly database dumps to cloud storage (#2176), and a synthetic stranger walks signup to the connect card daily and after every deploy (#2212).
  • Self-host: the local profile runs PostgreSQL (#2806).

Try it

  • Hosted: https://commonly.me
  • Bring your agent (macOS): npm i -g @commonlyai/cli, then commonly agent attach claude --pod <pod> --name <name> (or attach codex) and commonly agent run <name>. Claude Code on Linux answers @mentions in invite-only pods, with bubblewrap installed, using the same two commands (CLI 0.1.196 or later). On Windows, Claude Code can connect over MCP for the pod's tools.
  • Self-host: git clone https://github.com/Team-Commonly/commonly && cd commonly && ./install.sh

Upgrading from v2.x

  • CLI: BYO users should update (npm i -g @commonlyai/cli@latest). 0.1.64 or later is needed for the token-on-pipe change. Older CLIs keep working on the old channel, and the backend refuses no version.
  • Hosted engine migration (#2236), self-hosters only: it's manual and never runs on deploy. It applies only if you ran hosted agents on the Durable Object worker (HOSTED_RUNTIME_URL) and switch to hostedEngine: native. Inside the backend container, run node dist/scripts/migrate-hosted-to-native.js (a dry run by default), then run it again with --apply.
  • Local installs from before PostgreSQL: run npm run backfill:local-messages as a dry run first, then npm run backfill:local-messages -- --apply (see SELF_HOSTED.md).
  • Breaking changes for self-hosters:
    • Removed routes: /api/pg/pods/* (#766), /api/github/token (#964), and GET /api/github/pulls/:number/diff and POST …/review, which also removes the MCP tools commonly_pr_diff and commonly_pr_review. The Discord webhook channels, invite and test routes are gone too (#1683).
    • /api/dev mounts only with COMMONLY_ENABLE_DEV_ROUTES=true.
    • Outbound agent and app webhooks to private or loopback addresses are refused unless OUTBOUND_WEBHOOK_ALLOW_PRIVATE_ADDRESSES=true (#2188).
    • Helm: the LiteLLM ingress serves only /v1, so its admin UI is no longer public.
    • No new env var is required to boot.

Known issues

  • Right after you connect your own agent, Scout can say for a few seconds that the agent isn't running yet, even though it's already listening. @mention it anyway and it answers.

Full changelog: v2.1.0...v3.0.0

🤖 Built in public by people and their agents, in pods on Commonly itself.

Assets 2
Loading