Artel

Artel

あなたのエージェント群のための賢いメモ帳。使うほど学習します。

あなたと、あなたが実行するすべてのエージェントが書き込めるメモ帳です。誰かが解明したことは一度だけ書き留められ、必要なときにすぐ返されます。たとえば、ファイルを編集する直前に知っておきたいそのファイル特有の落とし穴、金曜日にどこまで進めたか、別のエージェントが苦労して学んだことなどです。分類も、タグ付けも、検索も必要ありません。普通のメモ帳は開かれるのを待ちますが、これは役立つ情報があるときに一行で知らせてくれます。ほとんどの場合、伝えることがなければ静かです。

情報を蓄積するだけではありません。あなたがいない間、バックグラウンドでアーキビストが蓄積された情報を整理するため、エージェント群が使うほどメモ帳は洗練されます。午前3時にあるセッションが学んだことを、朝にはほかの全員が知っています。同じことを二度解決する必要はありません。

自分のマシンで実行できます。どのクラウドにも情報は送られません。

どのように使えるか

エージェントがこれから…	Artel が伝えること	書いた人
auth.py を編集する	「時計のずれがあると、トークンの更新が何もせずに終わる」	先月の別のエージェント
月曜日に作業を始める	「金曜日は移行の途中で止めました。続きはこちらです」	週末前のあなた
不安定なテストをデバッグする	「3月にも発生しました。原因はテストではなく共有フィクスチャでした」	別のマシンのエージェント
質問する	答えになるメモをひとつ、または何も返さない	最初に遭遇した人

誰もファイルを開いて情報を探す必要はなく、誰に聞けばよいかを知っている必要もありません。

---

クイックスタート

接続先にできる公開インスタンスはありません。これはあなたのメモ帳なので、自分で実行します。コンテナひとつ、ポートひとつです。

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
# edit .env: set UI_PASSWORD, and a key for the archivist if you want one
# (ANTHROPIC_API_KEY, or OPENROUTER_API_KEY with ARCHIVIST_PROVIDER=openrouter)
docker compose up -d

API と UI は http://<host>:8000、MCP は http://<host>:8000/mcp で利用できます。イメージは ghcr.io/nicolasprimeau/artel:edge です。

起動したら、エージェントを登録します。

curl -fsSL http://<host>:8000/onboard | sh

mDNS に関する注意： mdns サービスは network_mode: host を使用しており、Linux でのみ動作します。Mac／Windows の Docker Desktop では削除してください。

---

内部の仕組み

サーバー、データベース、そして司書で構成されています。メモは HTTP または MCP 経由で登録され、埋め込み表現によってキーワードではなく意味に基づいて検索できます。キュー以降の処理はすべて、エージェントに求められることなく実行されます。

  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
                     ├── procedures · decisions · session handoffs
                     └── archivist: capture · synthesis · merge · decay · promote
        │
   mesh (CRDT feeds + mDNS) ◄──► your other machines

---

内容

以下はそれぞれドキュメントにページがあります。こちらが一覧です。

プラグイン	発言する側です。エージェントが行っている作業に近いメモがあるときだけ一行を返し、それ以外は何も返しません。エージェントが何かを呼び出す必要はありません。
キャプチャ	セッションは自動的にメモになり、約10 msでスプールされるため、書き込みによってエージェントの処理が遅くなることはありません。
アーキビスト	学習を担う部分です。重複を統合し、矛盾を解消し、事実でなくなった情報を徐々に薄れさせ、妥当性が保たれた情報を昇格させます。
コンパイルモード	コードに関するメモをコードに固定することで、古びるのではなく再導出されるようにします。
手順	書かれたスキルを手順にコンパイルします。サーバーが各手順をリポジトリと照合し、本当に完了したときに次の手順をエージェントに渡します。
決定事項	何を選び、その理由は何かを記録する追記専用の記録です。統合も、時間経過による減衰もしません。
メッシュとフィード	複数のマシンがCRDTとして収束し、さらに外部からRSS／Atomサブスクリプションを取り込みます。
ダッシュボード	ブラウザーから稼働環境を閲覧、検索、監視できます。

メモには寿命の異なる5種類があります。memory（事実でなくなると薄れていきます）、doc（確定したリファレンス）、directive（常時適用される指示。薄れることはありません）、skill（作業の進め方）、compiled（ソースに固定されています）。

HTTPまたはMCPに対応するエージェントなら、どれでも参加できます。Claude Code、OpenCode、Zed、生のhttpxスクリプトなどが該当します。クライアントの接続方法をご覧ください。

---

REST API

/agents/self-registerと/onboardを除き、すべてのリクエストにX-Agent-IDとX-API-Keyヘッダーが必要です。

**RESTリファレンス全文 →**には、OpenAPIスキーマから生成されたすべてのエンドポイントが記載されています。 **MCPツールリファレンス →**には、エージェントが呼び出せる47個のツールがすべて記載されています。

稼働中のサーバーは、/docsでインタラクティブなドキュメントを、openapi.jsonで生のスキーマも提供します。

---

設定

設定は環境変数（または.envファイル）だけで行います。主な項目は以下のとおりです。

変数	説明
AGENT_KEYS	カンマ区切りのagent-id:api-keyペアです。任意の:proj1;proj2サフィックスを指定すると、エージェントの対象プロジェクトを制限できます。
UI_PASSWORD	ダッシュボードのパスワードです。
ANTHROPIC_API_KEY	アーキビストを有効にします。これを設定しない場合、Artelはパッシブモードで動作します。
REGISTRATION_KEY	/agents/self-registerで必要です。未設定の場合、オープン登録は無効になります。
PUBLIC_URL	外部からアクセス可能なベースURLです。OAuthメタデータとオンボーディングで使用されます。

**設定リファレンス全文 →**には、サーバー、MCPアダプター、アーキビストにまたがる56項目すべての設定が記載されています。設定クラスから生成されています。

---

開発

uv sync --dev
uv run pytest tests/ -v

---

ライセンス

MITです。LICENSE.mdをご覧ください。