continuity

長期間のAI作業のための、ポータブルでgit対応のプロジェクト状態 — Claude Code、Cursor、またはMCPに対応したあらゆるツールで利用できます。

これはメモリツールではありません。 メモリツールは*「何について話しましたか？」に答えます。Continuityが答えるのは別の質問です：「このプロジェクトについて今何が真実で、何に触れてはいけないのか？」*

この設計にした理由

• 状態はプレーンなmarkdownファイルとして存在し、gitで追跡されます。 gitこそがイベントログです：履歴 = git log、ロールバック = git revert、監査 = git blame。すべての主張は人間が読め、差分を確認でき、手で編集できます。AIが取得した内容を、生成されたコードをレビューするのと同じ方法 — 差分として、いつでもレビューできます。取得時点での承認ゲートはありません。

• 2つの保存モード、1つのAPI。 リポジトリモード（<repo>/.continuity/、作業ディレクトリから上方向に探索して検出）は、Claude Codeのようにプロジェクトのcwdを持つエディタ/エージェントツールに適しています。セントラルモード（~/.continuity/projects/<name>/、名前付きプロジェクト）は、Claude Desktopのようにプロジェクトのcwdを持たないツールに適しています — プロジェクトを名前で参照するだけです。

• 再開コンテキストは、それらのファイルの決定的な射影です（読み取り経路にLLMはありません）— 凍結された制約、古いものを置き換えた理由を伴うアクティブな決定、再提案すべきでない却下された経路、未解決の質問、そして次のステップ。

• 信頼は盲目的な信仰ではなく、正直さから生まれます。 すべての主張にはconfidence + provenanceが付与されるため、新しいセッションは何が確認済みで何がAI推論かを把握し、すべてを信頼するのではなく調整を行います。

完全なアーキテクチャについてはDESIGN.mdを、その動機となった検証についてはpoc/を参照してください。

Related MCP server: KeepGoing MCP Server

インストール（Claudeプラグインとして）

ContinuityはClaude Codeプラグインであり、独自のプラグインマーケットプレイスとして配布されています — このリポジトリがマーケットプレイスです。Claude Codeが動作するすべての場所で動作します：ターミナル、デスクトップアプリ、Web。Claude Codeで：

/plugin marketplace add vikcena01/ai-continuity-plugin
/plugin install continuity@continuity-marketplace

これだけです — バンドルされたMCPサーバー、continuityスキル（自動再開 + 自動取得）、SessionStartフック、/resume /freeze /whyコマンドがすべて一緒にインストールされます。dist/はコミット済みで依存関係がゼロのため、インストール時のビルドステップはありません。

ローカル開発

npm install
npm run build   # typecheck + bundle to dist/
npm test        # build + 69 assertions across four suites

ループ（CLI）

continuity init "Build Snip, an internal URL shortener"
continuity record-decision "PostgreSQL is the source of truth" --body "ops knows it; volume is modest"
continuity reject "DynamoDB as primary store" --reason "KV overhead unjustified at our volume"
continuity record-constraint "Short codes are exactly 7-char base62" --body "printed in marketing + partner contract"
continuity freeze "7-char base62"     # lock an invariant — fuzzy: id OR title substring
continuity resume                     # <- the compact state a new session gets
continuity why "301"                  # <- what a decision replaced, and why
continuity resolve "8-char codes" --reject --reason "separate namespace"
continuity list                       # ids are short: d1k3, c2m9, x1p4, ...
continuity log                        # the git-backed event log

主張には短く入力可能なIDが付与されます — タイププレフィックス、連番、2文字のサフィックス：d1k3、c2m9、x1p4。サフィックスが並行作業を安全にします：これがないと、それぞれが16番目の決定を記録した2人の開発者が両方ともclaims/d16.mdに書き込み、マージ時に衝突します。freeze / why / supersede / resolveはIDまたはタイトルの部分文字列を受け付けます。状態はclaims/の下に書き込まれ、変更のたびにgitに自動コミットされます — ただし自動プッシュはされないため、resumeは未プッシュの取得コミットがあるときに警告します。

主張を閉じる

resolveだけが主張を終端ステータスに到達させる唯一の方法であり、理由は必須です — ただ消えてしまった主張は次のセッションに何も教えません：

continuity resolve <id-or-text> --accept --reason "..."   # a parked conflict wins
continuity resolve <id-or-text> --reject --reason "..."   # it becomes a guardrail
continuity resolve <id-or-text> --close  --reason "..."   # a settled risk/question

凍結された主張に対して保留されている主張を受け入れるには、追加で--unfreezeが必要です。凍結はモデルにおける唯一の人間の行為であるため、それを上書きするには2つ目の意図的な行為が必要です。

Claude Desktopでの使用（MCP）

MCPに対応しているがプロジェクトのcwdを持たないホストは、名前付きプロジェクトを持つMCPサーバーを使用できます。（注：Claude デスクトップアプリは内部でClaude Codeを実行するため、完全なプラグイン — フック、コマンド、スキル — がそこで動作します。このパスはプレーンなMCPホスト向けです。）ビルド（npm run build）してから、claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "continuity": {
      "command": "node",
      "args": ["/absolute/path/to/ai-continuity-plugin/dist/mcp.js"],
      "env": { "CONTINUITY_HOME": "/Users/you/.continuity/projects" }
    }
  }
}

その後チャットで："snipというcontinuityプロジェクトを作成" → create_project；"snipを再開" → resume_context；モデルが進行中に決定/制約/却下を記録します。ユーザーが呼び出せる**resumeプロンプト**が、Claude Codeの自動再開フックに代わるDesktop版です。ツール：list_projects、create_project、resume_context、record_decision、record_constraint、record_rejection、record_open、capture、resolve_claim、freeze_claim、why。

Claude Codeプラグインとして（ボーナス）

このリポジトリはClaude Codeプラグインでもあります（マニフェストは.claude-plugin/plugin.json）。そこでは、MCPサーバーに加えて、Claude Desktopではできないことが得られます：

• SessionStartフック（hooks/hooks.json）— 新しい/再開された/コンパクト化後のセッションでresume_contextを自動注入します — 自分から頼む必要はありません；

• Stopフック — ターン終了時の取得チェックを実行するため、誰かが頼むのを忘れても決定が記録されます。2つの独立したガード（stop_hook_activeと時間スロットル）によりループは不可能です；

• スラッシュコマンド/resume、/freeze、/why。

リポジトリには.claude/settings.jsonも同梱されており、コミット済みのdist/に対して同じフックを登録します。したがって、git cloneを実行するだけのコラボレーターは、何もインストールせずに自動再開と自動取得を利用できます。両方のフックはセッションごとに重複排除されるため、プラグインをインストールかつリポジトリをクローンしても問題ありません。

主張の形式

各.continuity/claims/<id>.md：

---
id: d4k7
type: decision            # decision | constraint | rejected_alternative | mission | milestone | question | next_action | ...
status: accepted          # accepted | frozen | superseded | rejected | open | needs_review | resolved | done
resolution:               # set by `resolve`: why this claim was closed
confidence: confirmed     # confirmed | tentative | unverified
provenance:
  origin: manual
  created: 2026-08-04T00:00:00.000Z
supersedes: []
superseded_by: null
depends_on: []
tags: []
---
Postgres is the primary datastore; a Redis read cache may come later.

主張の形式（契約）

他の誰かのリポジトリが主張を保持し始めると、ファイル形式は契約になります — そのためバージョンが付与されています：

---
schema: 1              # absent means 1
id: d16k3              # <type prefix><n><2-char suffix>; the suffix keeps concurrent clones from colliding
type: decision         # mission requirement decision constraint architecture milestone
                       # hypothesis experiment risk question next_action rejected_alternative
title: One crisp fact
status: accepted       # accepted active frozen open superseded invalidated rejected
                       # needs_review completed done resolved
confidence: confirmed  # unverified tentative confirmed
provenance: { origin: auto, created: ... }
supersedes: []
superseded_by: null
superseded_reason: ""  # why the replacement happened — travels with the claim
resolution: ""         # why it was closed, set by `continuity resolve`
---

Prose body. The reason, the context, whatever a future session needs.

安定性の約束。 古いContinuityによって書かれた主張は常に読み取れます：schemaがない場合は1を意味し、古い形状はファイルを書き換えずにメモリ内で前方移行されます。新しいContinuityによって書かれた主張は、半分だけ解析されるのではなく、名前によって大声で拒否されます — 理解できない形状を推測することは、状態が静かに劣化する方法です。continuity migrateは、ディスク上でバージョンを明示したいときに、現在のスキーマでファイルを書き換えます。

取得内容のレビュー

取得は自律的であるため、安全策は何が書き込まれたかを確認できることです：

continuity review            # semantic diff: what appeared, changed status, or was edited — and why
continuity review --accept   # mark it reviewed

手動編集もツールによる書き込みも検出され、再開コンテキストは変更が待機中であることを通知します。

ステータス

v1.0 — 決定的コア + CLI + MCPサーバー + Claude Codeプラグイン。 バージョン付き主張ファイル、衝突安全なID、あいまい検索、予算化された再開射影、git対応イベントログ、7つのスイートにわたる124のアサーション（npm test）。

現在動作しているもの：

• 自律的な取得 — 各ターン終了時のStopフックによって駆動されます — モデルが覚えているからではなく。

• すべてのバッチ取得の背後にあるレコンサイラー：重複排除、系統を保持する置換、そして凍結された主張に矛盾するものをneeds_reviewとして保留する凍結ガード（適用する代わりに）。

• resolve動詞 — レコンサイラーが保留したものを閉じ、リスク/質問が解決されたらそれらを閉じます。

既知の制限（このリポジトリ自身の.continuity/内の主張として追跡）：Stopフックの取得チェックは最大10秒に1回にスロットルされるため、非常に高速なやり取りで解決された決定は見逃される可能性があります（q3）；また、乱雑なセッションからの信頼性の高いステータス抽出が未解決の技術的リスクとして残っています（q2）。

マーク

Cが途切れることのない弧として描かれています — セッション間で生き残る糸 — ノード、つまり単一の取得された主張で終端します。assets/icon.svgはアバターやファビコン用の角丸タイル上の同じマークです。assets/logo-light.svgとassets/logo-dark.svgはワードマークのロックアップで、prefers-color-schemeによって選択されるため、両方のGitHubテーマで機能します。

ライセンス

MIT — LICENSEを参照。Copyright (c) 2026 Vikash。