{"slug": "show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work", "title": "Show HN: Busabase – an open-source system of record for AI agent work", "summary": "Busabase launched as an open-source, MIT-licensed database and workspace that gives AI agents a shared system of record, letting Claude Code, Codex, Cursor, Gemini CLI and custom agents read and write the same records, docs, skills and apps. The project runs via `npx busabase server` on localhost port 15419 with embedded PGlite and local file storage, and routes agent writes through Change Requests carrying a message, field-level diff, author and history, with permissions deciding whether a change merges immediately or waits for review. Busabase supports agent connections through Agent Skill, MCP, OpenAPI, CLI or ACP chat sessions, and ships Docker images at busabase/busabase and ghcr.io/busabase/busabase plus desktop builds for macOS, Windows and Linux.", "body_md": "Different agents. One shared base.\n\nThe open-source database & workspace where Claude Code, Codex, Cursor, and your own agents keep the records, docs, skills, and apps the next task builds on.\n\n[**Quick Start**](#quick-start)  · \n[Features](#features)  · \n[Connect an Agent](#connect-your-agent)  · \n[Use Cases](#use-cases)  · \n[Docs](https://busabase.com/docs)  · \n[Community](https://community.busabase.com/community)\n\nBusabase is an open-source database and workspace for AI agents — agents and people share the same structured data, docs, skills, and apps, and writes that matter become reviewed, trusted records.\n\nEvery agent session starts from zero. Your `CLAUDE.md` lives in one repo, the best output dies in a chat, and switching tools means explaining the project all over again.\n\nBusabase keeps the agents stateless and the work durable: connect any agent, and it reads the same records, docs, skills, and apps your team and other agents already left behind — then writes its own work back, with a diff and a history.\n\n```\nnpx busabase server\n```\n\nOpen **[http://localhost:15419/dashboard/local](http://localhost:15419/dashboard/local)** — no database, account, or config. It starts with embedded PGlite, local file storage, and a demo workspace.\n\nThen point your agent at it. Paste into Claude Code, Codex, Cursor, Gemini CLI, or any agent that can read a URL:\n\n```\nRead and follow the Busabase Agent Skill — it is the single source of truth:\nhttp://localhost:15419/SETUP_SKILL.md\n\nFollow its onboarding to connect to this workspace. Don't choose a merge policy yourself unless I ask for one — submit the change and let Busabase apply my permissions to decide whether it merges now or waits for review. Reply to me in English.\n```\n\n**Try this:** have one agent record a project's updates and conventions, then open a different agent and ask *\"What changed on this project this week?\"* It answers from the workspace, not from your clipboard.\n\n## **Docker · Desktop · global install · from source**\n\n```\n# Docker (Docker Hub: busabase/busabase · GHCR: ghcr.io/busabase/busabase)\ndocker run --rm -p 15419:15419 -v ~/.busabase/data:/data busabase/busabase\n\n# Global install\nnpm i -g busabase       # then: busabase server\nnpx busabase-cli --help # API client for any Busabase server\n\n# From source\npnpm install\ncp apps/busabase/.env.example apps/busabase/.env\npnpm --filter busabase dev\n```\n\n**Desktop** for macOS, Windows, and Linux: **[busabase.com/download](https://busabase.com/download)** — runs locally and works offline.\n\nLocal data lives in `~/.busabase/data/` (`pgdata/` for the embedded PGlite database, `storage/` for files). Set `BUSABASE_DATA_DIR`, `PG_DATABASE_URL`, or `STORAGE_URL` to use another location, external Postgres, or S3-compatible storage. Only one process can hold the same PGlite database at a time.\n\n- **One workspace for every kind of agent output** — Bases (typed records, relations, views, forms), Docs, Files, Drives, Skills, AirApps, Whiteboards, and Workflows as first-class nodes in one tree.[Node types →](https://github.com/busabase/busabase/blob/main/apps/busabase/docs/node-types.md)\n- **Shared skills across agents** — keep`SKILL.md` playbooks and custom prompts in the workspace.**Playbooks** collects them into one catalog every connected agent can look up before it acts.\n- **Every write accounted for** — agent writes travel as Change Requests with a message, a field-level diff, an author, and history. Permissions decide whether a change merges on the spot or waits for review.\n- **Apps on live data** — ask an agent to turn a Base into a dashboard, CRM, or content desk. AirApps run inside Busabase on workspace data, with a`SKILL.md` the next agent can read.\n- **Bring any agent** — no built-in model, no lock-in. Agent Skill, MCP, OpenAPI, CLI, or an ACP chat session.\n- **Templates** — install a whole working setup (Bases, views, docs, sample data, apps, and its agent manual) in one command.\n- **Local-first and open source** — MIT, embedded database, works offline. The same engine powers[Busabase Cloud](https://busabase.com) .\n\n| **Database** — typed, related, queryable records | **Knowledge base** — durable docs with version history | \n| **Skills** — reusable instructions and supporting files | **Apps** — focused interfaces built on workspace data | \n| **Change Requests** — see exactly what an agent changed | **History** — source, reviewer, commit, and timeline | \n| **Whiteboards** — visual context shared with agents | **Workflows** — processes kept beside their data | \n\nWorks with **Claude Code · Codex · Cursor · Gemini CLI · OpenCode · OpenClaw · Hermes · Buda AI · n8n** — or your own process.\n\n| Connection | Best for | \n|---|---|\n| **Agent Skill** | Coding agents and local CLIs that can follow workspace instructions | \n| **MCP** | Tool-aware agents and IDEs that need typed workspace operations | \n| **OpenAPI / CLI** | Apps, scripts, automations, and custom agents | \n| **Agents view (ACP)** | Conversational sessions with inline tool activity and permission requests | \n\nGuides: [Claude Code](https://github.com/busabase/busabase/blob/main/apps/busabase/docs/claude-code.md) · [DeepSeek Harness](https://github.com/busabase/busabase/blob/main/apps/busabase/docs/deepseek-harness.md) · [Bring Your Own Agent](https://github.com/busabase/busabase/blob/main/apps/busabase/docs/bring-your-agent.md). Open **Agent Skills** in the sidebar for the MCP endpoint and OpenAPI spec of your running instance (`/api/v1/doc`). Also on [Glama's MCP directory](https://glama.ai/mcp/connectors/com.busabase/busabase).\n\n## **How writes work**\n\n```\nAgent reads workspace context\n        ↓\nAgent writes data, docs, skills, or app changes — always as a Change Request\n        ↓\nYour permissions decide: it merges on the spot, or it waits in the Inbox\n        ↓\nEither way the change stays inspectable, attributable, and reversible\n```\n\nA credential capped at `changeRequest` level can only propose; a single call can opt in with `autoMerge: false`; `busabase-cli install … --require-review` holds a package's content back for approval. Anything else that is allowed to write, writes — and still leaves a diff and a history behind.\n\n| Workspace | What agents do | What stays in Busabase | \n|---|---|---|\n| **Software delivery** | Turn feedback into tasks, write and test code, ship, start the next cycle | Feedback, tasks, specs, conventions, release notes | \n| **SEO & content** | Track search trends, plan, draft the next article in a shared CMS | Keyword research, briefs, drafts, published pages | \n| **CRM** | Research prospects, follow up, log every visit | Companies, contacts, visit notes, follow-ups | \n| **Team memory** | Capture decisions, sources, and operating context | A knowledge base the next agent starts from | \n| **Datasets** | Label examples, attach evidence, score quality | Reviewed training and evaluation data | \n\nStart from a template — the whole app, its data, and the manual that tells an agent how to use it:\n\n```\nbusabase-cli install https://github.com/busabase/templates/tree/main/templates/busa-crm\n```\n\nBrowse [busabase.com/templates](https://busabase.com/templates) and [all use cases](https://github.com/busabase/busabase/blob/main/apps/busabase/docs/use-cases.md).\n\n|  | Designed for | Missing when agents do the work | \n|---|---|---|\n| Airtable, Notion, Baserow, NocoDB | People editing directly | Agent-native access, shared skills and apps, a proposal boundary | \n| Postgres | Applications reading and writing storage | A workspace UI, knowledge model, review loop, and provenance | \n| Agent memory, vector DBs | One agent recalling context | Structured facts people can open, cite, and correct | \n| **Busabase** | **People and agents building one workspace** | — | \n\nBusabase runs on Postgres (or embedded PGlite) itself; it is the workspace on top, not a replacement for your app's database.\n\n| Open source / Personal Desktop | Busabase Cloud | \n|---|---|\n| MIT-licensed and free | Hosted, multi-user workspace | \n| Local PGlite and file storage | Managed Postgres and object storage | \n| No login, works offline | Spaces, roles, permissions, Team Insights | \n| Data stays on your machine | Web and mobile access | \n\n**Cloud Connect** links a local workspace to [Busabase Cloud](https://busabase.com) through an authenticated tunnel — your machine keeps the data and runs local agents. See [pricing](https://busabase.com/pricing).\n\n`apps/busabase` is the local, single-workspace Next.js shell. The workspace engine lives in `packages/busabase-core`: nodes, records, file trees, rich node types, review primitives, search, agents, and API contracts — exposed through MCP, OpenAPI, and `busabase-cli`. Cloud runs the same engine with multi-tenant identity, permissions, and hosted storage.\n\n**Security:** the open-source server is designed for a trusted local machine or private network. Do not expose write endpoints to the public internet without authentication and a reverse proxy; use scoped credentials and Cloud Connect for remote access.\n\n```\npnpm install\npnpm --filter busabase dev\npnpm --filter busabase typecheck\npnpm --filter busabase lint:err\n```\n\nBug reports, ideas, docs, and pull requests are welcome in [Issues](https://github.com/busabase/busabase/issues) and [Discussions](https://github.com/busabase/busabase/discussions).\n\n[Website](https://busabase.com) · [Docs](https://busabase.com/docs) · [Forum](https://community.busabase.com/community) · [YouTube](https://www.youtube.com/@BusabaseAI) · [X](https://x.com/Busabase4agent) · [LinkedIn](https://www.linkedin.com/company/busabase/)\n\nIf Busabase is useful to you, a ⭐ helps other agent builders find it.\n\n[MIT](https://github.com/busabase/busabase/blob/main/LICENSE) © Busabase", "url": "https://wpnews.pro/news/show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work", "canonical_source": "https://github.com/busabase/busabase", "published_at": "2026-10-16 15:09:28+00:00", "updated_at": "2026-10-16 15:16:57.400353+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools", "ai-infrastructure"], "entities": ["Busabase", "Claude Code", "Codex", "Cursor", "Gemini CLI", "PGlite", "Docker Hub", "GitHub Container Registry"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work", "markdown": "https://wpnews.pro/news/show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work.md", "text": "https://wpnews.pro/news/show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work.txt", "jsonld": "https://wpnews.pro/news/show-hn-busabase-an-open-source-system-of-record-for-ai-agent-work.jsonld"}}