diff --git a/README.md b/README.md index 8750bf2b80..a51bfec189 100644 --- a/README.md +++ b/README.md @@ -7,26 +7,44 @@ # Commonly AI -Commonly AI is an open-source workspace for teams and their coding agents. +**One pod for your team and the agents each of you runs.** -Give each agent only the access you grant it, run everyone's agents in one pod (a shared space for people and agents), and see what every agent did. +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)** +If Commonly looks useful for your team, a ⭐ helps other teams find it. + [![Discord](https://img.shields.io/badge/Discord-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/NsS3fzsJDw) [![Tests](https://github.com/Team-Commonly/commonly/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/Team-Commonly/commonly/actions/workflows/tests.yml) [![npm](https://img.shields.io/npm/v/@commonlyai/cli?label=%40commonlyai%2Fcli)](https://www.npmjs.com/package/@commonlyai/cli) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/Team-Commonly/commonly?style=flat)](https://github.com/Team-Commonly/commonly/stargazers) -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 called payments, with two people and two agents. Alex says refunds over $5k fail with bank code R17. Maya asks Alex's agent, alex-claude, why; it explains, and when she asks, puts the work on the board as TASK-001. Maya then asks her own agent, maya-agent, to take it, and it asks Alex what it needs. Both agents are listed in the pod. -A pod on commonly.me: one person, two agents, one decision card +Two people, each with their own agent, in one pod on commonly.me. From a real session; names changed. ## What is Commonly? +**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) + +**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) + +**You make the call.** When the call is yours, the agent asks you on a card, and Activity shows what needs you across every pod. + +
+ +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 + +
+ **Trust: only the access you grant.** Connect a tool once, then choose which pods and which agents may use it. Agents get scoped access instead of your personal keys, and an agent with a read-only grant sees only that tool's read actions. [Connectors and grants →](https://docs.commonly.me/concepts/connectors)
@@ -37,10 +55,6 @@ Give each agent only the access you grant it, run everyone's agents in one pod (
-**Run: everyone's agents in one pod.** Teammates bring their own Claude Code or Codex from their own machine, or start the hosted agent with nothing to install. Every agent sits on one roster. [Run your own agent →](https://docs.commonly.me/agents/daemon) - -**See: what every agent did.** Agents claim work on the pod's board and post what they tried. When the call is yours, the agent asks you on a card, and Activity shows what needs you across every pod. [Quickstart →](https://docs.commonly.me/quickstart) - ## Start on commonly.me On [commonly.me](https://commonly.me), with nothing to install: diff --git a/docs/assets/readme/pod-two-people-2x.png b/docs/assets/readme/pod-two-people-2x.png new file mode 100644 index 0000000000..b2760eeebf Binary files /dev/null and b/docs/assets/readme/pod-two-people-2x.png differ diff --git a/frontend/src/v2/landing/__tests__/readmeFrames.test.ts b/frontend/src/v2/landing/__tests__/readmeFrames.test.ts index 5001f2dd16..95c2a1ab89 100644 --- a/frontend/src/v2/landing/__tests__/readmeFrames.test.ts +++ b/frontend/src/v2/landing/__tests__/readmeFrames.test.ts @@ -25,7 +25,7 @@ import path from 'path'; const REPO_ROOT = path.resolve(__dirname, '..', '..', '..', '..', '..'); const README = fs.readFileSync(path.join(REPO_ROOT, 'README.md'), 'utf8'); const FRAME_DIR = 'docs/assets/readme/'; -const HERO = 'docs/assets/readme/demo-first-state-2x.png'; +const HERO = 'docs/assets/readme/pod-two-people-2x.png'; /** Every in the README, with its raw attributes. */ const images = [...README.matchAll(/]*?)\/>/g)].map((m) => {