okamyuji

Kizami — Development skill for Claude Code

Development community

Claude Code / Codex / Kimi Codeの会話を自動記録し、過去の記憶を検索・注入するローカル長期記憶システム.

How to install Kizami

This entry records only its repository, not the path inside it, so there is no exact command to give. Open okamyuji/kizami and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Kizami does

Claude Code / Codex / Kimi Codeの会話を自動記録し、過去の記憶を検索・注入するローカル長期記憶システム.

Alternatives in Development

Understand Anything — Graphs that teach graphs that impress 80.7k ★
OpenAI Codex CLI — (Rust implementation) 67.8k ★
Career-Ops For Codex — Read CLAUDE.md for all project instructions, routing, and behavioral rules 32.5k ★

README

Kizami

Claude Codeのセッション会話を自動的に記録し、過去の議論や設計判断を検索できるようにするローカル長期記憶システムです。 [sui-memory](https://zenn.dev/noprogllama/articles/7c24b2c2410213)の設計思想を継承しつつ、TypeScriptで再実装しています。

特徴

JSONL正本 + SQLiteキャッシュの二層構成 (v0.2.0〜): 月＋ホスト単位の append-only JSONL を正本とし、SQLite は派生キャッシュとして再生成可能です。Git同期・障害復旧・スキーマ実験に強い構成です
SessionStart hook で冒頭注入 (v0.2.0〜): セッション開始時に同プロジェクトの直近Q&Aを自動でコンテキスト先頭に注入します
Claude Code / Codex / Kimi 対応 (Codex: v0.3.0〜, Kimi: v0.4.1〜): Claude Code は既存 transcript 方式、Codex / Kimi (kimi-code, Moonshot AI) は hook payload 方式で保存・注入します
JSONL v2トランザクション + turn checkpoint (v0.5.0〜): begin/payload/commit のトランザクションframeとpayload digest検証により、クラッシュ途中の書き込みを正本から決定的に除外します。ターン単位のcheckpointは revision と history epoch で改訂・resetを追跡します
検証済みエラー解決記録 (v0.6.0〜): 同一プロジェクト・同一セッションで、生コマンドがbyte単位で一致する明示的失敗の後の明示的成功を「検証済み解決」として記録し、kizami resolutions で検索できます
HF_HUB_OFFLINEデフォルト化 (v0.2.0〜): hybridモードの埋め込み生成時に Hugging Face Hub への暗黙テレメトリ/ping を遮断します
セッション終了時にトランスクリプトを自動で保存します
プロンプト送信時に関連する過去の記憶を自動で注入します
外部APIやモデルのダウンロードは不要です(coreモード)
hybridモードではRuri v3日本語embeddingによるベクトル検索も利用できます
DB肥大化を防ぐ自動メンテナンス機能を内蔵しています(90日超の古いチャンク・実行観測の削除、サイズ上限制御)
CLIから記憶の検索、編集、削除ができます

設計原則

#	原則	説明
1	外部依存の排除	SQLite単一ファイルに全データを格納します。外部APIや大規模モデルのダウンロードは不要です
2	保存時トークン消費ゼロ	LLMを使わずにチャンク化します。ルールベースの処理のみで動作します
3	自動保存	SessionEnd hookにより手動操作なしで保存が行われます
4	常時参照	UserPromptSubmit hookにより毎メッセージ送信時に自動的に関連記憶を注入します
5	編集と削除	CLIから履歴の検索、編集、削除ができます