Introduction

Agent Commons is an open platform for building, running, and connecting AI agents.

Agent Commons gives an agent everything it needs to do real work: a model, a toolbelt, memory, a place to keep files, a computer it can log into, a schedule, a wallet, and a record of where every answer came from.

You can drive all of it from the web app, the agc CLI, the TypeScript SDK, or plain HTTP.

New here? The Quickstart has an agent answering you in about five minutes.

Pick an interface

Web app

Studio, chat, workflows, and knowledge in the browser

CLI

agc — chat, run, schedule, and ship from the terminal

TypeScript SDK

npm i @agent-commons/sdk

REST API

Any language, one bearer token

What an agent can do

Capability	Where it lives
Chat with streamed tokens, tools, and attachments	Agents
Call your APIs, MCP servers, and built-in platform tools	Tools & MCP
Follow reusable, publishable playbooks	Skills
Read and write shared documents and files	Knowledge & library
Remember facts across sessions	Memory
Run multi-step graphs with approvals	Workflows
Wake on a cron schedule or a heartbeat	Tasks & scheduling
Get a persistent Linux box with a browser	Computers
Act as you in Google, GitHub, and Slack	Connections
Delegate to other agents over an open protocol	A2A
Show its sources and export a signed bundle	Provenance
Hold USDC and pay for what it uses	Wallets

Thirty seconds of code

import { CommonsClient } from '@agent-commons/sdk';
 
const commons = new CommonsClient({ apiKey: process.env.COMMONS_API_KEY });
 
const { data: agent } = await commons.agents.create({
  name: 'Research Bot',
  instructions: 'You research topics and answer with sources.',
  modelProvider: 'anthropic',
  modelId: 'claude-sonnet-4-6',
});
 
for await (const event of commons.agents.stream({
  agentId: agent.agentId,
  messages: [{ role: 'user', content: 'What changed in EU AI rules this month?' }],
})) {
  if (event.type === 'token') process.stdout.write(event.content ?? '');
}

How the pieces fit

                        You  ·  agc CLI  ·  SDK  ·  REST
                                     │
                        ┌────────────┴────────────┐
                        │   api.agentcommons.io   │  bearer token, scopes,
                        │        (gateway)        │  rate limits
                        └────────────┬────────────┘
                                     │
   ┌──────────────┬──────────────────┼──────────────────┬──────────────┐
   │              │                  │                  │              │
[Session]     [Task]            [Workflow]           [A2A]        [Space]
   │              │                  │                  │              │
   └──────────────┴────────┬─────────┴──────────────────┴──────────────┘
                           ▼
                        [Agent]  ── model · instructions · skills
                           │
        ┌──────────┬───────┼────────┬───────────┬──────────┐
        ▼          ▼       ▼        ▼           ▼          ▼
    [Tools]    [Memory] [Library] [Knowledge] [Computer] [Wallet]
     static                                                 │
     custom  ── every call is recorded ──► [Provenance] ────┘
     MCP

Where things run

Surface	URL
Web app	www.agentcommons.io
API	`https://api.agentcommons.io`
Identity & API keys	auth.agentcommons.io/platform
Source	github.com/Arttribute/agent-commons

Stack: Next.js 15 · NestJS 11 · LangGraph · PostgreSQL · Base Sepolia