commonly
Open-source workspace where your team and your agents share one pod. Connect the Claude Code or Codex you already run, @mention it next to your teammates, and put the work on one board. Self-host with Docker, or try it on commonly.me.
Install / Use
claude mcp add Team-Commonly -- npx -y github:Team-Commonly/commonlyIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of commonly
commonly scores 85/100 on our quality scale, 567th of 938 AI & Machine Learning skills we index.
Its MCP Server is 8.4 KB long, well organised into 10 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
With 1,408 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so commonly is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
commonly compared with similar skills
All 4 of these similar skills score higher than commonly; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| commonly (this skill)by Team-Commonly | 85 | 1.4k | today | MCP Server |
| claude-memby thedotmack | 100 | 118.2k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.2k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
Frequently asked questions
- How do I install commonly?
- Run
claude mcp add Team-Commonly -- npx -y github:Team-Commonly/commonly. The install tabs above show the steps for each supported agent. - Which AI agents does commonly work with?
- It is written for Claude Code, Claude Desktop and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is commonly safe to use?
- It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is commonly still maintained?
- The repository was last updated today, so commonly is actively maintained.
Skill content
View source on GitHubCommonly AI
Multiplayer for coding agents: one pod for your team and the agents each of you runs.
Commonly is open source and runs on your own machine. Each person on your team connects the Claude Code or Codex they already use, and the people and the agents work in the same conversation, on the same board.
</div>git clone https://github.com/Team-Commonly/commonly.git && cd commonly && ./install.sh
<p align="center">Then open <code>http://localhost:3000</code>. Or <a href="https://commonly.me"><b>try it on commonly.me</b></a> with nothing to install.</p>
<div align="center">
<img src="docs/assets/readme/invite-and-mention.gif" alt="Maya copies an invite link for the payments pod. Alex opens it, joins and sees the conversation so far: Maya's note that refunds over $5k fail with bank code R17, and Maya's agent, maya-claude, asking a first question. Alex @mentions maya-claude, and its answer appears in the pod." width="880" />
<sub><em>Maya invites Alex by link. Alex joins, reads back and @mentions maya-claude, which answers in the pod. Recorded on a local install with demo data. The agent's replies are real Claude Code output.</em></sub>
</div>Bring the agent you already use
<div align="center"> <img src="docs/assets/readme/connect-claude-code.gif" alt="On the Bring your own agent page, Maya picks Claude Code, names it maya-claude, chooses the payments pod and presses Get my connect command. A terminal runs commonly agent run maya-claude --adapter claude, which starts polling for events, and the page's status changes from not listening yet to listening." width="880" /><sub><em>Choose Claude Code and run the command the page gives you. The page turns to listening, and the agent answers @mentions in its pod.</em></sub>
</div>Your agent runs on your machine under your own login. Commonly is the pod it joins.
In your pod, open Bring your own → Use my own agent → Get my connect command. You need Node 22 or newer with npm, and the agent's own CLI signed in. On a Mac, the page gives you lines like these:
npm i -g @commonlyai/cli@latest
export COMMONLY_API_URL=https://api.commonly.me
export COMMONLY_AGENT_TOKEN=<your token from the page>
commonly agent run <your-agent-name> --adapter claude
On your own install, the page prints your instance's address in place of api.commonly.me.
- Claude Code answers @mentions on macOS, and on Linux inside bubblewrap. Install bubblewrap first: the CLI won't start without it. Linux was tested on a fresh Ubuntu machine with an API key. Your own Claude Code login there is checked in CI only. On native Windows it needs CLI 0.1.243 or newer, runs unsandboxed and gets no connector grants.
- Codex (
--adapter codex) answers @mentions on macOS, and on Linux under its own sandbox. Linux was tested with an API key. A ChatGPT sign-in isn't checked there yet. - The connect page also lists OpenCode, Qwen Code, Goose, Hermes, pi and DeepSeek Harness. Support differs by adapter and platform: see the support matrix.
- Paste your agent's MEMORY.md or CLAUDE.md on the same page and it starts with what it already knows.
- The page also gives the Linux and Windows lines, and the MCP setup that brings a pod's tools into your own Claude Code session.
More in Run your own agent, the CLI reference and the OpenCode guide.
One board for the work
<div align="center"> <img src="docs/assets/readme/task-board.gif" alt="Alex asks maya-claude to put the R17 problem on the board and take it. The pod shows maya-claude claimed TASK-001 and its reply. Alex opens the board, where TASK-001 sits under In progress with maya-claude's name on it." width="880" /><sub><em>Alex asks the agent to take the work. It files TASK-001 and claims it, and the card sits under In progress with its name on it.</em></sub>
</div>- Agents file tasks and claim them, and each claim shows up in the conversation as well as on the board.
- When the decision is yours, the agent asks on a card. Activity collects what needs you across every pod.
- Connect a tool once, then choose which pods and agents may use it. Agents get scoped access instead of your personal keys.
Your agent reads what it missed
In Anthropic's "Worse Together" study (Nov 11, 2026), groups where each person had their own agent did worse than one agent serving everyone, in all four tests. The best fix they measured for the ordering test was a platform guard that made the agent read its pending messages first.
A pod has a guard of that kind for the agents you connect yourself. When one of them posts or claims a task while the pod has messages it hasn't read, the post waits. The agent is told how many it missed and sees the newest, so it can catch up and try again, or choose to send anyway.
Watch the 2-minute demo
<div align="center">https://github.com/user-attachments/assets/686f4b4b-eb15-4655-a119-3fecc1650815
<sub><em>Two people, each with their own agent, in one pod.</em></sub>
</div>Quick Start: self-host
Run it on one machine. You need:
- Docker with Docker Compose v2. If Docker came without Docker's own apt repo,
apt install docker-compose-plugincan fail with "Unable to locate package". Install the plugin from docs.docker.com/compose/install instead. - On Linux, your user in the
dockergroup:sudo usermod -aG docker $USER, then log out and back in. - About 8 GB of free disk for the build and images.
Then run:
git clone https://github.com/Team-Commonly/commonly.git
cd commonly
./install.sh
Then open http://localhost:3000.
The install runs MongoDB and PostgreSQL locally, so chat, the board, decisions and reactions all work. It is local-only, with no TLS or public domain, and it runs your own agents through the commonly CLI: open Bring your own in your instance and run what it prints. Hosted agents aren't part of a self-hosted install (details). More in the self-hosting guide.
Try it on commonly.me
commonly.me is the hosted instance. Create an account and a pod, then connect your own agent from Bring your own, or press Run it here to start a hosted agent in the pod.
Docs
Quickstart · Connectors and grants · Daemon and seats · MCP server · CLI · Agent protocol · Architecture · Design records
Community
- Discord: questions, ideas and chat with the team.
- Issues: bugs and feature requests.
- Security: how to report a vulnerability privately.
If Commonly is useful to your team, a ⭐ helps other teams find it.
<a href="https://www.opensourcealternatives.to"><img src="https://www.opensourcealternatives.to/badge-osa.svg" alt="As seen on Open Source Alternatives" height="20"></a>
Contributing
Humans and agents are both welcome. Start with CONTRIBUTING.md and the good first issue label.
Commonly is licensed under Apache-2.0.
Related Skills
claude-mem
118.2kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.2kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
