Seamless

Seamless

AI コーディングエージェントは、学習した内容がコンテキストウィンドウを超えて残らないため、セッションのたびに同じ制約を再発見します。同じバックログに対して 2 つのエージェントを実行すると、同じステップを選び、二重に実装してしまいます。そして、こうした問題の解決をうたう製品は、プロジェクトの記憶を他社のデータベースに保存します。

Seamless は、AI コーディングエージェント向けのローカル優先のメモリおよび連携基盤です。Claude Code、Codex CLI、あらゆる MCP クライアントで動作します。また、コード以外の長期的な作業では、Claude デスクトップアプリのチャットからも利用できます。Claude アプリでの Seamlessをご覧ください。

エージェント群に、共有できる永続的なメモリと、衝突せずに作業を分担する手段を提供します。置き換えライフサイクルを備えたメモリ、ハイブリッド検索、リースベースの割り当てに対応する依存関係対応のタスクキュー、保存された計画、調査トライアルを利用できます。永続的な知識はディスク上の Markdown ファイルに保存されます。seamlessd デーモンはそれらをインデックス化し、MCP 経由で提供して、ウェブコンソールに表示します。また、付属の seam CLI はヘッドレスエージェントに直接インターフェースを提供します。

完全なドキュメント：thereisnospoon.org/docs/  ·  ウェブサイト：thereisnospoon.org（ソースは docs/にあります）

Arctopが開発・公開しています。MIT ライセンスです。

設計原則

• 単独のエージェントではなく、エージェント群向けに構築。 依存関係に対応する準備完了キュー、リースベースのアトミックなタスク割り当て、メモとステップで構成される計画という、実用的な連携プリミティブを備えているため、エージェントは衝突せずに作業を分担できます。
• ファイルが信頼できる唯一の情報源です。 すべてのメモリとメモは、~/.seamless 以下の YAML フロントマター付き Markdown ファイルです。Git で差分を確認でき、grep で検索でき、手作業で編集できます。SQLite はこれらのファイルをインデックス化し、セッション、タスク、トライアル、イベントなどの運用状態も保存するため、データディレクトリ全体をバックアップしてください。
• 整理役は提案し、判断するのは人間です。 重複の解消やアーカイブから、不要な情報や知識の不足の指摘まで、整理役による各処理は提案のみを行います。適用は明示的な操作です。置き換えによって出所が保たれるため、何も気付かないうちに書き換えられることはありません。
• 小型で自己完結したランタイム。 静的 Go デーモンと CLI を採用し、CGO 不要、Pure Go の SQLite を使用します。Node も、別個のベクトルエンジンも、クラウドアカウントも必要ありません。

比較

エージェントメモリの領域はいくつかの分かりやすいカテゴリーに分かれています。カテゴリーごとに比較するのは、カテゴリーは古くならないためです。

	Seamless	クラウドメモリ API	組み込みエージェントメモリ	ナレッジグラフサーバー
ストレージ形式	手元のディスク上の Markdown ファイル。SQLite がインデックス化し、運用状態を保存	API キーでアクセスする各社のデータベース	1 つの製品内にあるベンダー管理のストア	多くの場合、別サーバーとして稼働するグラフデータベース
実行場所	自分のマシン。localhost のみ	各社のクラウド	ベンダーの製品	自分のマシン、またはベンダー側
アカウントが必要	いいえ	はい	ベンダーのアカウントが必要	通常は不要
マルチエージェント連携	タスクキュー、リースベースの割り当て、共有計画	なし	なし――1 つのエージェントに 1 つのストア	共有読み取りができる程度
忘却ポリシー	出所を保った置き換え。整理役が提案し、人間が判断	制御できない自動要約	ベンダーが定義	手動
ランタイム	静的 Go デーモンと CLI	各社のサービスに接続する HTTP SDK	なし（組み込み）	Node または Python とデータベース

製品名と根拠を含むバージョンについては、完全な比較をご覧ください。

実際のトランスクリプト

実際の未編集の Claude Code セッションを4組掲載しています。同じプロンプト、同じリポジトリで、Seamless を使用した場合と使用しない場合を比較できます。

• コールドスタート — 一方のセッションは、注入されたブリーフィングをもとに昨日の計画を続行します。もう一方は TODO から作業を再導出し、プロジェクトがすでに一度修正したバグを再び出荷します。
• 制約違反 — セキュリティスキャナーが SameSite=Strict を要求しますが、チームはすでに、それによって外部リンクからのログインが壊れることを把握しています。一方のセッションはそのままリグレッションを出荷し、もう一方は拒否して、記録された制約を根拠として示します。
• トークンの安全性 — リフレッシュトークンの永続化を指示されると、一方のエージェントはメモリー上のマップを生のトークンを格納する SQL カラムに複製します。もう一方は、まず記録済みのルールを確認し、SHA-256 ハッシュのみを保存します。
• タスクの競合 — 2つの稼働中のエージェントが、同じ計画ステップを同時に確保しようとします。一方の要求が通り、もう一方は確保したエージェントの名前とともに拒否され、次に実行可能なステップへ切り替えます。

Seamless ではないもの

ホスト型のチーム向けナレッジベースでも、RAG フレームワークでも、ベンチマークの勝者でもありません。1人の所有者が自身のマシン上で使う、エージェント群のためのメモリーと連携機能です。

クイックスタート

curl -fsSL https://thereisnospoon.org/install | sh

Windows では、PowerShell で同じものをインストールします。

irm https://thereisnospoon.org/install.ps1 | iex

インストールはこれだけです。必要なのは curl と tar だけで、それ以外は不要です。Go も、CGO ツールチェーンも、データベースも、Node も必要ありません。プラットフォーム（macOS、Linux、Windows。amd64 と arm64）用のチェックサム検証済みリリースアーカイブを取得し、seamlessd と seam を ~/.local/bin にインストールします。ベアラキーを生成し、検出された Claude Code／Codex のローカルホスト向けにフック、MCP、スキルをインストールして、デーモンをユーザー単位のサービスとして実行します。macOS では launchd、Linux では systemd --user、Windows ではログオン時に実行するスケジュールタスクを使います。常に最新の状態を保ちます。v0.7.0 以降は、各リリースの公開から1日後、どのエージェントも使用していないタイミングで、新しいリリースを自動インストールします。バックアップを取っておき、新しいリリースが起動しない場合はロールバックします。今すぐ更新するには seamlessd update を実行します（--check でインストール済みのバージョンと最新バージョンを確認できます）。設定と ~/.seamless は保持されます。

開発初期のため、リリース頻度は高めです。 Seamless は開発サイクルの初期段階にあり、改善やバグ修正を含むリリースを頻繁に公開しています。インストーラー経由のインストールでは v0.7.0 以降、自動更新されます。v0.6.0 以前の場合は、seamlessd update を一度実行してください。更新とアンインストールをご覧ください。

（なぜ seam なのか？ CLI では Seam v1 の短い名前を引き継いでいます。Seamless は、非公開だった旧版 Seam を置き換えるため、一から再構築されました。）

あとは、git リポジトリ内で選択したクライアントを起動するだけです。プロジェクトを作成したり、リポジトリを登録したりする必要はありません。セッション開始フックが現在の作業ディレクトリを git ルートに解決し、リポジトリのディレクトリ名からプロジェクトを導出して、その対応関係をその場で記録します。そのため、エージェントは呼び出しのたびに指定しなくても、プロジェクトのスコープを引き継ぎます。導出されたスラッグを上書きする場合に限り、seamlessd map-repo --path ~/code/myrepo --project myrepo を使用してください。

これは1つのシェルスクリプトです。見知らぬ人のスクリプトをシェルにパイプする前に、まず内容を確認してください。Homebrew、go install、ビルド済みアーカイブなど、各手順を個別に実行したい場合や、上書き用のオプションが必要な場合は、インストールとデプロイをご覧ください。クイックスタートでは、OS とクライアントに応じて各手順を案内します。

続けて読む：クイックスタート · Claude Code のセットアップ · Claude アプリのチャット設定 · Codex ローカルセットアップ · インストールとデプロイ

ドキュメント

ドキュメントの全文は thereisnospoon.org/docs/ にあります（ソースは docs-src/、cmd/docsgen によって生成されます）。

コンセプト	メモリーとノート、セッションとブリーフィング、想起、タスクと計画、プロジェクトとスコープ、ガーデナー
ガイド	エージェントの統合、想起されるメモリーの書き方、フリートの調整、トラブルシューティング
リファレンス	すべての MCP ツール、両方の CLI、すべての設定キー、フック、ファイル形式
内部構造	アーキテクチャ、コントリビューション、ドメインの不変条件

この README は意図的に短くしています。コードとの乖離が生じる可能性のあるもの（ツール数、設定キー、CLI フラグなど）はすべてドキュメントサイトに記載しています。リファレンスページはコードから生成され、古くなると make check が失敗します。

開発

make build      # ./bin/seamlessd + ./bin/seam
make test       # unit tests
make test-race  # unit tests under the race detector
make bench      # hot-path benchmarks (recall, briefing, matcher, event fan-out)
make lint       # golangci-lint
make check      # the full gate: build + vet + cross-check + fmt-check +
                # docs-check + installer-check + site-check + lint +
                # vulncheck + test-race
make doctor     # config + database self-checks
make run        # serve on 127.0.0.1:8081

make docs       # regenerate the docs site (docs-src/ -> docs/docs/, committed)
make docs-serve # regenerate + serve the site at 127.0.0.1:8899/docs/

テストはテーブル駆動で、初期状態の SQLite またはインメモリー SQLite に対して testify/require を使用します。gofmt -w . ではなく make fmt を使用してください。Make ターゲットは Git で追跡されているファイルにフォーマット対象を限定しますが、単純な gofmt の走査では、Go の ./... パターンが除外するドットディレクトリも書き換えてしまいます。

ドキュメントサイトの docs/docs/ 以下の出力はコミット対象であり、make check は docs-check を実行します。そのため、docs-src/ や、リファレンスの生成元となるツールの公開インターフェースまたは設定キーを変更した場合は、同じ変更内で make docs を実行してください。詳細は SITE.md を参照してください。

規約は AGENTS.md に記載されています。コードを書く前にお読みください。