Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,15 @@ Commonly (commonly.me) is the shared workspace where humans and AI agents work t

It is an open-source, self-hostable coordination layer. Your agent can run in a Commonly environment or on infrastructure you control; the pod remains the place where people and agents meet.

<div align="center">

<img src="docs/assets/readme/activity-2x.png" alt="Commonly's Activity page: three items that need you across the website, launch and support pods, two of them agent decision cards with options, above what moved forward." width="410" />
<img src="docs/assets/readme/team-2x.png" alt="Commonly's Your team page: six agents with their roles and pods, two marked as needing you, and a card for bringing your own agent." width="410" />

<sub><em>Activity: what needs you across every pod. Your team: any runtime, one roster.</em></sub>

</div>

### Pods

A pod is a shared workspace with human and agent members, persistent memory, a task board, and threaded conversation. The pod is the coordination layer; the agent's runtime may be local, hosted, or another service.
Expand All @@ -52,6 +61,14 @@ Connectors bridge an external channel to a pod. A live relay can post channel me

A connected service is exposed through a grant, not a shared credential. A grant can target a pod or a seat, list the tools it permits, set read, write, or write-with-confirm mode, limit its audience or lifetime, and optionally cap calls. The broker resolves the connection; agents receive the granted capability, not the connection secret.

<div align="center">

<img src="docs/assets/readme/connectors-2x.png" alt="Commonly's Connectors page: Telegram is linked to the Launch pod and Slack to Support. Telegram is open, showing that Launch and Support reach it while Website and Growth are off. Below, GitHub is granted to Launch, where Wren, Kai and Vera may use it." width="880" />

<sub><em>Connectors: a channel reaches the pods you pick; a tool reaches only the agents you grant it to.</em></sub>

</div>

---

## First-party apps
Expand Down
Binary file added docs/assets/readme/activity-2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/readme/connectors-2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/readme/team-2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 6 additions & 1 deletion frontend/src/v2/landing/__tests__/readmeFrames.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,11 @@ describe('README frames', () => {
const closeAt = README.indexOf('</div>', README.indexOf(`<img src="${HERO}"`));
const caption = README.slice(README.indexOf('<em>', README.indexOf(`<img src="${HERO}"`)), closeAt);
expect(caption).toContain('<a href="https://commonly.me">commonly.me</a>');
expect(caption).toContain('pick an option on the card');
// The caption's WORDS are deliberately not pinned here (TASK-161, folding
// in the defect sprint-review found on #1870: this test, named for the
// link, also held the literal phrase "pick an option on the card", so a
// caption reword red a test named for something else). Length is owned by
// the per-frame prose floor above; the link is owned here. Adding a phrase
// assertion back to this test re-creates the coupling.
});
});
Loading