kira

Kira

エージェントが自分の失敗を繰り返さなくなります。

失敗した再試行も、例外も、「待って、先週まったく同じ壁にぶつかったよね」という事態も、セッションが終わるとエージェントが捨ててしまう知識です。Kira はそれを保持します。MCP を一度インストールするだけで、エージェントは何に苦しんだかを記録し（傷跡）、再び作業する前にその傷跡を確認して、同じ失敗に二度もコストを払わずに済みます。

プライバシーを設計に組み込みました。 個人の傷跡と検索ミスのログはローカルのみで管理され、どのプランでもアップロードされることはありません。コミュニティのテレメトリはオプトイン方式で、書き込み前にローカルで、さらに保存前にサーバー側で、秘密情報、パス、識別子を削除します。npm run demo:privacy を実行すると、マシンの外に送信される情報を正確に確認できます。完全なワイヤーフォーマットとオプトアウト方法については、PRIVACY.md をご覧ください。

---

インストール（10秒）

次のスニペットを MCP ホストの設定に追加してください。

{
  "mcpServers": {
    "kira": {
      "command": "npx",
      "args": ["-y", "kira-mcp@latest"]
    }
  }
}

これで完了です。エージェントが Kira を利用できるようになります。

クライアントごとのパス（クリック）

クライアント	設定ファイル
Claude Code	~/.claude/settings.json（グローバル）または .claude/settings.json（プロジェクトごと）
Claude Desktop	macOS：~/Library/Application Support/Claude/claude_desktop_config.json · Windows：%APPDATA%\Claude\claude_desktop_config.json
Cursor	~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）
Cline / Continue	拡張機能の設定 → MCP サーバー
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code (MCP preview)	.vscode/mcp.json
Goose	~/.config/goose/profiles.yaml（extensions: の下）
Zed	~/.config/zed/settings.json（context_servers）

上記のスニペットはどのクライアントでもそのまま使えます。mcpServers（またはクライアントで相当するキー）の下に貼り付けてください。

---

30秒でわかるループ

Monday    agent gates a merge on:  npm run build 2>&1 | tail -1
          exit code comes from tail, not the compiler → broken code reaches main
          └─ kira_record_failure(
               title:   "build gate bypassed: exit code swallowed by pipe to tail",
               instead: "never gate on a piped command without pipefail")

Tuesday   new session, same machine
          └─ session brief: "⚠ You have been burned by this before:
             never gate on a piped command without set -o pipefail"
          agent writes the gate correctly. Zero repeats. Zero wasted tokens.

これは仮説ではありません。データベースに記録された最初の実際の傷跡で、この機能を構築したエージェントが、構築中に犯した失敗について記録したものです。その後の3つの傷跡も、同じ日に記録されました。このループは初日から、単一ユーザーでも、ネットワーク効果が一切なくても機能します。改善ループの全容については、FLYWHEEL.md をご覧ください。

---

ツール（10）

	ツール	内容
個人の記憶	kira_record_failure	リトライや例外を、個人の傷として記録します（ローカルのみ）
	kira_personal_brief	最新の傷をまとめたセッション開始時のブリーフです。どこで痛い目に遭ったかを把握してから作業を始められます
	kira_premortem	目標に取りかかる前に失敗のヒートマップを作成します。「この種のタスクで、どこで痛い目に遭ったか」を確認できます
カタログ	kira_lookup	キーワードから、実証済みの手順と失敗への警告を検索します。該当がない場合も、何も返さずに終わるのではなく、スコア付きの near_skills / near_scars を返します
	kira_get	ID を指定して、手順を最初から最後まで取得します
	kira_route	目標から、各ステップにスキルを割り当てた順序付きの計画を作成します
コミュニティ	kira_share_scar	個人の傷をコミュニティへの投稿候補にします（情報はサニタイズされ、クリックするまで何もアップロードされません）。貢献者ステータスを獲得できます
フィードバック	kira_report	成功／リトライ／失敗を報告し、品質改善ループに反映します
	kira_consent / kira_status	テレメトリーへの同意と、1 回の呼び出しでの状態確認

自動実行： Kira を呼び出す必要はありません。Kira の MCP 指示が、エージェントにいつ呼び出すかを伝えます。日本語のクエリにも標準で対応しています（CJK のバイグラム照合）。

該当するものがない場合

検索に該当しなくても、行き止まりではありません。それは需要のデータです。Kira はスコア付きの最も近い候補を返し、該当しなかったことを（何が近かったかとともに）ローカルに記録します。週次のフライホイールダイジェストは、繰り返される検索漏れをエイリアスの修正や新しいスキル候補に変換します。カタログは、人々が実際に何を尋ねるかを学習します。

---

カタログレイヤー（コミュニティのスキルと傷）

デプロイ／データベース／認証／決済／UI／テスト／CI／インフラ／モバイル／CMS にわたる 38 件のコミュニティスキルと、45 件のコミュニティの傷があります。「Vercel のデプロイは成功するのにアプリがクラッシュする：環境変数が不足している」や「Auth.js v5 の signIn を誤った側からインポートした」といった、実際の失敗パターンが含まれます。kira_route は「ウェブアプリを作る」という目標を、各ステップに適切なスキルと傷を割り当てた順序付きの計画に変換します。

コミュニティの傷は、個人の傷が昇格する場所です。投稿フローはすでに利用できます。 エージェントに kira_share_scar(scar_id) の実行を依頼してください。個人の傷が再度サニタイズされ、一般化されたうえで、入力済みの投稿リンクが表示されます（クリックするまで何もアップロードされません）。受付ボットが JSON を検証し、人間が内容を確認します。マージされると、すべての Kira ユーザーに配信されます。フォームを使いたい場合は、傷を直接投稿してください。

承認された傷を共有するたびに、貢献者ステータスを獲得できます。共有することで、新しいフィードを無料で利用できます（詳しくは下記の「貢献」をご覧ください）。

---

仕組み

Your agent hits a wall            Your agent gets a task
    ↓                                 ↓
kira_record_failure()             kira_premortem(goal) / kira_lookup(keyword)
    ↓                                 ↓
~/.kira/personal-scars/           scars first, then instructions
    ↓                                 ↓
next session: brief surfaces      agent announces → executes → kira_report()
your scars before work starts         ↓
    ↓                             misses + failure notes feed the flywheel
never the same mistake twice      → digest → catalog improvements

スキルは自然言語で書かれた Markdown であり、実行可能なコードを含まないため、インジェクションのリスクはありません。

---

CLAUDE.md だけではだめなのですか？

	CLAUDE.md / .cursorrules	Kira
セットアップ	プロジェクトごとにコピー	一度だけインストール
失敗の記憶	覚えていれば手動で書きます	kira_record_failure — 発生した瞬間に記録
想起	覚えていれば読み直します	セッション開始時／タスク開始時に自動表示
選択	自分で選びます	エージェントがスコアに基づいて選択
更新	手動	自動（フライホイール）
AI ツールをまたいで利用	ツール固有	あらゆる MCP クライアント

「別の“メモリー MCP”」ではありません

優れたメモリーサーバーは数多くあります（ナレッジグラフ、セッションの想起、コンテキストの引き継ぎなど）。Kira は意図的に対象を絞っています。

• 何でも保存するのではなく、失敗を最優先します。 一般的なメモリーは何が起きたかを保存しますが、Kira は回避するために設計された形式で、二度と起きてはならないことを保存します。mistake → instead、重大度、再発回数を記録します。タスク前のヒートマップ（kira_premortem）が存在するのは、データが失敗に関するものだからです。
• 再発は推測せず、測定します。 類似した失敗を再記録すると、同じ傷跡に統合され、hit_count が増加します。コーパスは実際にどの壁にぶつかっているかを学習し、レビューによって正確な件数が保たれます。
• 共有資産は積み重なっていきます。 あなたの傷跡は、匿名化され、人のレビューを受けたうえで、すべてのインストール環境に配信されます。それにより、新しいフィードを利用できます（RECIPROCITY.md）。メモリーサーバーは1つのエージェントを賢くしますが、傷跡のコーパスはすべてのエージェントを同じ失敗から守ります。
• 信頼は暗黙の前提ではなく、設計によって実現します。 コーパスのテキストはエージェントのコンテキストに挿入されるため、すべての項目に対して、CI でのサニタイザー安定性チェック、自然言語のみを使うルール、人によるレビューを実施しています（SECURITY.md）。

一般的なエピソード記憶が必要な場合は、そうしたサーバーのいずれかを Kira と併用してください。同じ役割を競うものではありません。

---

テレメトリ

個人用の傷跡（~/.kira/personal-scars/）と見落としログ（~/.kira/misses.log）はローカルにのみ保存され、アップロードされることはありません。コミュニティテレメトリはこれとは別で、同意した場合のみ有効になります。

モード（KIRA_TELEMETRY 環境変数、または kira_consent MCP ツール）	お使いのマシンから送信される情報
off	何も送信されません。ログはローカルにのみ保存されます。
basic (デフォルト)	匿名化された基本情報：スキル ID、ステータス、匿名 UUID、Kira のバージョン、OS ファミリー、Node のメジャーバージョン、無料／Pro のプラン。自由記述は含まれません。
full	basic と同じ情報に加え、サニタイズ済みの note / context（シークレット、パス、識別子を削除）。

スキーマの全容、削除ルール、保存期間、オプトアウトの手順については、PRIVACY.md をご覧ください。

環境変数	デフォルト	用途
KIRA_TELEMETRY	（未設定 → basic）	このプロセスの同意レベルを上書きします：off、basic、full。
KIRA_TELEMETRY_URL	https://kira-telemetry.workers.dev/v1/reports	一括アップロード先のエンドポイント。
KIRA_HOME	~/.kira	同意状態、個人用の傷跡、見落としログ、フライホイールの出力先。
KIRA_KEY	（未設定 → 無料プラン）	貢献者／支援者キー。新しいコミュニティフィードを利用できます。
KIRA_REMOTE_URL	（未設定 → ネットワーク接続なし）	無料プラン向けコーパスフィードのオプトイン URL（共有資産の内容は90日遅れで提供）。

---

傷跡を共有するか、購読するか、待つ

コーパスは MIT ライセンスで、収録された内容はいずれすべて無料になります。プレミアムなのは情報の新しさだけです。モデルの再トレーニングに伴い、失敗に関する知識は古くなるため、最新の傷跡に価値があります。

	新しいコミュニティフィード	方法
貢献者	✅ 無料	採用された傷跡1件につき12か月（kira_share_scar → マージ → キー）。最初の1,000人の貢献者は永久利用可能です。
支援者	✅ 有料	プロジェクトを支援して、支援者キーを取得します。すべての投稿の人によるレビューに資金が使われます。
無料	90日後	ベースコーパスは npm とともに配布されます。遅延配信の共有資産フィードは、オプトインで利用できます。ローカル機能とプライバシーの保証は、すべてのプランで永久に無料です。

現在は猶予モードです。コーパスがコミュニティの傷跡100件に達するまで、新しいフィードはすべての人に公開されます。ポリシーの詳細：RECIPROCITY.md。

---

貢献

最初の1,000人の貢献者は、新しいフィードを含むKiraのすべての機能を永久に無料で利用できます。上の相互貢献の表をご覧ください。

スキルと傷跡の追加方法については、CONTRIBUTING.md をご覧ください。

---

リンク

• npm
• フライホイール — 改善ループの仕組み
• 設計思想
• 事業計画
• 使用ガイド
• トラブルシューティング

---

エージェントが真価を発揮するのは、どこで痛い目に遭ったかを覚えているときです。

B Button Corporation のプロジェクトです。