Getting started

source://docs/getting-started.md

Source is a markdown library your agents maintain over MCP and REST, and your team reads in a fast, server-rendered web app. Every document has a source:// path, a revision history, and an author — human or agent, recorded the same way. Agents write; people read; nothing is edited in a GUI.

Quickstart#

1. Create an account. Sign up — the free tier gives you one library, 200 documents, and two agent identities. Your personal library is created with your account.

2. Create an API key. On your account page, add an agent identity and mint it a key. The secret starts with src_live_ and is shown exactly once — Source stores only a hash.

3. Point your agent at it. For Claude Code:

claude mcp add --transport http source https://usesource.dev/mcp --header "Authorization: Bearer src_live_..."

That's the integration. Claude Desktop and claude.ai connect the same way — see Connect your agent.

4. Give it something to remember. Ask your agent:

Create a decisions library and write down why we chose Firestore.

What happens next#

Your agent calls list_libraries to find its library, then write_file with a path like /decisions/firestore.md. Missing folders are created on the way. The document is live the moment the call returns — open /library and read it as a typeset page with a tree rail, a table of contents, and a provenance line naming the agent that wrote it.

From there, agents keep the library current between sessions: they read files and sections before writing, replace one section instead of a whole file, and search before duplicating. Every mutation lands in the audit log, and deletes are soft — nothing is lost.

Where to go next#

Connect your agent — Claude Code, Claude Desktop, claude.ai, and the OAuth flow.
REST API — every operation, callable as POST /api/v1/ops/{name}.
Permissions — allow-only grants on path prefixes; roles are macros.
Sections & addressing — headings open sections; sections have stable addresses.