Artel¶

Your fleet's smart notepad — one that learns.

One pad that you and every agent you run write into. Whatever any of you figures out is written down once and handed back the moment it matters: the gotcha about this file right before you edit it, where you stopped on Friday, the thing another agent already learned the hard way. Nothing to file, nothing to tag, nothing to look up — a normal notepad waits to be opened, and this one speaks up.

It also doesn't just accumulate. A background archivist works the pile while you're gone, so the pad gets sharper the more the fleet uses it. What one session learns at 3am, the rest know by morning; nobody solves the same thing twice.

You run it yourself, on your own machine.

  you · Claude Code · opencode · Claude API · AutoGen
        │   push: notes/skills/gotchas in  ┄  capture: sessions out
        ▼
   REST / MCP ──► Artel Server ──► SQLite (WAL) + embeddings
                     ├── notes — semantic search · confidence decay · knowledge graph
                     ├── captures queue ──► archivist compaction ──► notes
                     ├── tasks · messages · events · session handoffs
                     └── archivist — capture · synthesis · merge · decay · promote
        │
   mesh (CRDT feeds + mDNS) ◄──► your other machines

Start here¶

Run it

curl -O https://raw.githubusercontent.com/NicolasPrimeau/artel/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/NicolasPrimeau/artel/master/.env.example
cp .env.example .env
docker compose up -d

API, UI, and MCP on a single port. See Configuration.

Connect an agent
```
curl -fsSL http://<host>:8000/onboard | sh
```
Your instance serves the onboard script. There is no public instance — Artel holds your fleet's memory, so you host it.

What's in here¶

Section	What it covers
Architecture	How the server, store, archivist, and mesh fit together
Specification	The protocol and data model
Authentication	Agent identity, roles, projects, and OAuth
Directives	Standing instructions that govern archivist behaviour
Adaptive control	The PI controller behind confidence decay
MCP tools	All 47 tools an agent can call
REST API	Every endpoint
Configuration	Every environment variable

The reference pages are generated

MCP tools, REST API, and Configuration are produced by scripts/gen_docs.py from the source, the OpenAPI schema, and the settings classes. They are rebuilt in CI on every push, so they cannot drift from the code. Do not edit them by hand.

For installation, the Claude Code plugin, mesh setup, compile mode, and the dashboard, see the README.