CLIリファレンス¶

すべてのコマンドで --json フラグが使えます。

グローバルオプション¶

ほぼ全コマンド共通のフラグ:

オプション	説明
`--brain`, `-b`	Brainルートディレクトリ（自動探索を上書き）
`--json`	マシンリーダブルなJSON出力

Brain管理¶

`spkt init`¶

カレントディレクトリに新しいBrainを作成します。フラグなしなら対話ウィザードが立ち上がります。 --json や --provider を指定すれば非対話で実行できます。

$ spkt init

Brain name [my-project]:
Configure embeddings? [y/N]: y
  Providers: openai-compat, ollama
  Provider [openai-compat]:
  Base URL [http://localhost:1234/v1]:
  Model [text-embedding-nomic-embed-text-v1.5]:
  Dimension [768]:

--- Summary ---
...
Create brain? [Y/n]:

非対話（スクリプト・エージェント向け）:

spkt init -p none                      # 埋め込みなし
spkt init --name my-brain -p openai-compat \
  --base-url http://localhost:1234/v1 \
  --model text-embedding-nomic-embed-text-v1.5
spkt init -p ollama --json             # エージェント向けJSON出力

`spkt config`¶

いまのBrain設定を表示します。

spkt config
spkt config --json

`spkt embed-all`¶

エンベディング未生成のNeuronをまとめて処理します。実行前にNeuron数と推定トークン数が表示され、確認を求められます。

spkt embed-all              # 対話式 — 実行計画を表示して確認
spkt embed-all --yes        # 確認をスキップ

Neuronコマンド¶

`spkt neuron add`¶

Neuronを追加します。

spkt neuron add "# Functor\n\n圏の間の写像。" -t concept -d math
spkt neuron add "内容" --type fact --domain physics
spkt neuron add "内容" -t concept --source-url "https://example.com/paper.pdf" --source-title "論文"

オプション	説明
`-t`, `--type`	Neuronタイプ（例: `concept`, `fact`, `procedure`）
`-d`, `--domain`	知識ドメイン（例: `math`, `french`）
`--source-url`	出典URL（引用追跡用）
`--source-title`	出典タイトル（`--source-url`と併用）

`spkt neuron list`¶

Neuronの一覧。フィルタやメタデータ探索にも対応。

spkt neuron list
spkt neuron list -t concept -d math
spkt neuron list --limit 50

# メタデータ探索
spkt neuron list --meta-keys --json          # 全Sourceのfilterable/searchableキー一覧
spkt neuron list --meta-values year --json   # キーの値一覧（件数付き）

オプション	説明
`-t`, `--type`	タイプでフィルタ
`-d`, `--domain`	ドメインでフィルタ
`--limit`	最大件数
`--meta-keys`	メタデータキー一覧（filterable + searchable）
`--meta-values KEY`	指定キーの値一覧

`spkt neuron inspect`¶

Neuronの詳細を表示します。コンテンツ、FSRS状態、圧力、出典、コミュニティ、接続中のSynapseが確認できます。

spkt neuron inspect <neuron-id>
spkt neuron inspect <neuron-id> --json    # sources[]とcommunity_idを含む

`spkt neuron remove`¶

Neuronとそのすべてのシナプスを削除します。

spkt neuron remove <neuron-id>
spkt neuron remove <neuron-id> --json

`spkt neuron merge`¶

複数のNeuronを1つにまとめます。コンテンツは結合、Synapseはターゲットに付け替え、Source紐付けも移管。統合後にターゲットを再エンベディングします。

spkt neuron merge <source-id-1> <source-id-2> --into <target-id>
spkt neuron merge <id1> <id2> <id3> --into <target-id> --json

`spkt neuron due`¶

復習が必要なNeuronを表示します。自動生成Neuron （_metaドメイン・community_summaryタイプ）は対象外です。

spkt neuron due
spkt neuron due -n 20
spkt neuron due --json

`spkt neuron fire`¶

復習を記録します（スパイクの発火）。自動生成Neuronには使えません。

spkt neuron fire <neuron-id> --grade fire
spkt neuron fire <neuron-id> -g strong

グレード	意味	FSRS Rating
`miss`	失火（不正解）	Again
`weak`	弱発火（怪しい）	Hard
`fire`	発火（正解）	Good
`strong`	強発火（完璧）	Easy

Synapseコマンド¶

`spkt synapse add`¶

2つのNeuron間にSynapseを作成します。

spkt synapse add <pre-id> <post-id> --type requires
spkt synapse add <a-id> <b-id> --type relates_to

タイプ	方向	用途
`requires`	片方向	Aを理解するにはBが必要
`extends`	片方向	AはBを拡張する
`contrasts`	双方向	AとBは対比関係
`relates_to`	双方向	一般的な関連
`summarizes`	片方向	コミュニティ要約 → メンバー

`spkt synapse list`¶

Synapseの一覧。

spkt synapse list
spkt synapse list --neuron <neuron-id>     # 特定のNeuronに接続するシナプス
spkt synapse list --type requires          # タイプでフィルタ
spkt synapse list --json

信頼度タグ（[inferred], [ambiguous]）があれば併記されます。

`spkt synapse weight`¶

既存Synapseの重みを変更します。

spkt synapse weight <pre-id> <post-id> 0.8
spkt synapse weight <pre-id> <post-id> 0.5 --json

`spkt synapse remove`¶

2つのNeuron間のSynapseを削除します。

spkt synapse remove <pre-id> <post-id>
spkt synapse remove <pre-id> <post-id> --json

Sourceコマンド¶

`spkt source ingest`¶

URL・ファイル・ディレクトリを取り込みます。Sourceレコードを作成し、抽出したコンテンツをエージェントによるチャンキングに渡します。

# URL
spkt source ingest "https://example.com/article" -d cs --json

# ファイル
spkt source ingest ./notes.md -d math --json

# ディレクトリ（一括取り込み）
spkt source ingest ./papers/ -d cs --json

オプション	説明
`-d`, `--domain`	ドメインタグ
`--title`	ソースタイトルを上書き（単一ファイル/URLのみ）
`--force`	searchableメタデータのサイズ超過時、切り詰めて続行

ディレクトリ取り込みはテキストファイル（.md, .txt, .rst, .htmlなど）を一括処理します。metadata.jsonlを置くとメタデータを付与できます:

{"file_name": "paper1.md", "title": "Paper One", "filterable": {"year": "2024", "venue": "NeurIPS"}, "searchable": {"abstract": "We propose..."}}
{"file_name": "paper2.md", "filterable": {"year": "2023"}}

searchableがmax_searchable_chars（デフォルト: 500）を超えるファイルがあると中断します。--force で切り詰めて続行できます。

`spkt source list`¶

全Sourceの一覧（Neuron数付き）。

spkt source list
spkt source list --json

`spkt source inspect`¶

Sourceの詳細と紐づくNeuronを表示します。

spkt source inspect <source-id>
spkt source inspect <source-id> --json

`spkt source update`¶

Sourceのメタデータ（URL、タイトル、著者）を更新します。

spkt source update <source-id> --url "https://new-url.com"
spkt source update <source-id> --title "新しいタイトル" --author "著者名"

`spkt source refresh`¶

URLソースを再取得して変更がないかチェックします。条件付きGET（ETag / Last-Modified）で帯域を節約しつつ、内容が変わっていれば関連Neuronを再エンベディングします。

spkt source refresh <source-id>          # 特定のSourceを更新
spkt source refresh --stale 30           # 30日以上未取得のSourceを更新
spkt source refresh --all                # 全URLソースを更新

404を返すSourceは unreachable としてマークされます。

Domainコマンド¶

`spkt domain list`¶

全ドメインをNeuron数付きで表示します。

spkt domain list
spkt domain list --json

`spkt domain rename`¶

ドメイン名を一括変更します。

spkt domain rename old-name new-name

`spkt domain merge`¶

複数のドメインを1つに統合します。

spkt domain merge domain1 domain2 --into target-domain

`spkt domain audit`¶

ドメインラベルとコミュニティ構造のズレを分析します。ユーザーが付けたドメインと、グラフから自然に浮かび上がるコミュニティを突き合わせて、以下のミスマッチを検出します:

分割: ひとつのドメインが複数コミュニティにまたがっている → サブドメインを提案
統合: 複数のドメインがひとつのコミュニティに集中している → マージを提案

コミュニティごとのTF-IDFキーワード抽出で命名のヒントも出します。

spkt domain audit
spkt domain audit --json

Communityコマンド¶

`spkt community detect`¶

Louvainアルゴリズムでコミュニティを検出します。

spkt community detect
spkt community detect -r 2.0              # 高解像度 = より多くのコミュニティ
spkt community detect --summarize          # コミュニティごとに要約Neuronも生成
spkt community detect --json

`spkt community list`¶

現在のコミュニティ割り当てを表示します。

spkt community list
spkt community list --json

検索¶

`spkt retrieve`¶

グラフ構造を考慮した検索。キーワード、セマンティック類似度、 FSRS検索可能性、中心性、復習圧力を総合的にスコアリングします。

spkt retrieve "圏論"
spkt retrieve "functor" --limit 5

# フィルタ付き検索
spkt retrieve "attention" --filter year=2017
spkt retrieve "GNN" --filter domain=cs --filter venue=NeurIPS

オプション	説明
`--limit`, `-n`	最大件数（デフォルト: 10）
`--filter KEY=VALUE`	Neuronフィールド（`type`, `domain`）またはSourceのfilterableメタデータでフィルタ。複数指定可。キーが存在しないSourceは除外。

復習¶

`spkt quiz`¶

インタラクティブなフラッシュカード復習セッション。理解度に応じた出題（Scaffold）で、Textual TUI 上でセルフグレーディングします。

spkt quiz                 # Textual TUI（デフォルト）
spkt quiz --limit 10
spkt quiz --json          # 期限到来カードのRenderResponseを一括ダンプして終了
spkt quiz --no-tui        # 標準入出力でJSONループ（1行=1カード）

TUIキー

キー	動作
`Space`	カードをめくる（表↔裏）
`1`	成績: Forgot（忘れた／MISS）
`2`	成績: Uncertain（怪しい／WEAK）
`3`	成績: Got it（できた／FIRE）
`4`	成績: Perfect（完璧／STRONG）
`n`	現在のカードにノートを追加
`q`	セッションを終了

n で入力したノートは spike.notes に保存され、将来の矛盾検知・フィードバックキュー等に活用されます。

エージェント向けモード

--json: 期限到来カード全件の {status, count, items: [RenderResponse...]} を一括出力。エージェント側でUIを描画する場合に使用。
--no-tui: 1カードごとに RenderResponse をstdoutに1行出力し、 stdinから QuizResponse（例: {"self_grade": "FIRE", "notes": "..."}）を 1行読む。{"action": "quit"} で途中終了。

Brain健全性とインサイト¶

`spkt stats`¶

Circuit統計を表示します: Neuron数、Synapse数、グラフ密度。

spkt stats
spkt stats --json

`spkt diagnose`¶

Brainの健全性を診断します。孤立Neuron、弱いSynapse、長期放置のNeuronなど、潜在的な問題を洗い出します。

spkt diagnose
spkt diagnose --json

`spkt progress`¶

学習の進捗レポートを生成します。復習状況、定着率、ドメインごとのカバレッジ、成長トレンドなどが確認できます。

spkt progress
spkt progress --format html -o progress.html
spkt progress --json

`spkt manual`¶

Brainの中身からユーザーガイドを自動生成します。ドメイン・トピック・復習期限・ソースを一覧化。

spkt manual
spkt manual --format html -o manual.html
spkt manual --write-meta                   # ガイドを_meta Neuronとしても書き込み
spkt manual --json

統合（Consolidation）¶

`spkt consolidate`¶

睡眠中の記憶統合にヒントを得たグラフ最適化。Brainを分析し、弱いSynapseの剪定や未使用接続の減衰を行う計画を生成します。

spkt consolidate                           # ドライラン — 計画を表示
spkt consolidate --domain math             # ドメインを限定
spkt consolidate --json

`spkt consolidate apply`¶

統合計画を実行します。計画生成時のグラフ状態と現在の状態をハッシュで照合し、変更がないことを確認してから適用します。

spkt consolidate apply                     # ドライラン確認後に適用
spkt consolidate apply --json

可視化¶

`spkt visualize`¶

インタラクティブなHTMLグラフを生成します。

spkt visualize
spkt visualize -o my-graph.html

エクスポート / インポート¶

`spkt export`¶

Brainをバックアップ・共有・デプロイ用にエクスポートします。

# tarball（フルバックアップ）
spkt export -o backup.tar.gz

# JSONバンドル（ポータブル、人間が読める）
spkt export --format json -o brain.json
spkt export --format json --include-embeddings -o brain-full.json

# QABotバンドル（デプロイ用の読み取り専用SQLite）
spkt export --format qabot -o qa-bundle.db

フォーマット	内容	用途
`tar`（デフォルト）	`.spikuit/`ディレクトリ全体	バックアップ、移行
`json`	Neuron、Synapse、SourceをJSON化	共有、検査
`qabot`	エンベディング付きの最小SQLite	ポータブルRAGデプロイ

QABotバンドルはNeuron・Synapse・エンベディング・出典だけを詰めた軽量SQLiteです。FSRS状態や復習履歴は含みません。 Circuit(read_only=True) で読み込めます。

`spkt import`¶

tarballバックアップをインポートします。

spkt import backup.tar.gz

エクストラクタ（`spkt skills extractor`）¶

エクストラクタはプラガブルな取り込み戦略です。各エクストラクタは SKILL.md + manifest.toml のバンドルで、spkt source ingest の中で Agent CLI から呼び出されます。エクストラクタは2層構造で、ブランド内エントリがシステム同名を上書きします（shadcn-style）：

1. <BRAIN>/.spikuit/extractors/<name>/                       (brain, 優先)
2. <spkt-install>/skills/spkt-ingest/extractors/<name>/      (system)

Spikuit は default エクストラクタ（汎用 markdown チャンカ）と _template/ スケルトンを同梱しています。

`spkt skills extractor list`¶

解決済みエクストラクタとそのティアを一覧表示します。

spkt skills extractor list
spkt skills extractor list --json

`spkt skills extractor status`¶

各エクストラクタの [requires] をホスト環境（PATH 上のコマンド、import 可能な Python パッケージ）に対して検査します。実行可能か、ユーザーに何かインストールしてもらう必要があるかを判断するのに使います。

spkt skills extractor status              # 全件
spkt skills extractor status pdf-paper    # 単体
spkt skills extractor status --json

JSON出力:

[
  {"name": "default", "available": true, "missing_commands": [], "missing_python_packages": []},
  {"name": "pdf-paper", "available": false, "missing_commands": [], "missing_python_packages": ["pymupdf"]}
]

`spkt skills extractor show <name>`¶

manifest と SKILL.md 全文を表示します。

`spkt skills extractor fork <name> [<new-name>]`¶

システムエクストラクタを brain にコピーして編集可能にします。<new-name> を省略すると同名のままシステム版を上書きします。

spkt skills extractor fork default               # システムdefaultを上書き
spkt skills extractor fork default my-default    # 別名で複製

`spkt skills extractor add <path>`¶

外部のエクストラクタディレクトリ（manifest.toml + SKILL.md 必須）を brain にインストールします。

`spkt skills extractor remove <name>`¶

brain-local エクストラクタを削除します。システム同梱のものは削除できません。

`spkt skills extractor refresh`¶

手動編集後に <brain>/.spikuit/extractors/_registry.toml を再生成します。

バージョン管理（gitバックエンド）¶

spkt init はBrain内にgitリポジトリを作成し、変更を全て履歴に残します。バッチ取り込みや構造変更の前に短命ブランチを切り、結果を確認してから main にfast-forwardするのがエージェントの想定運用です。

`spkt branch start`¶

main から ingest/consolidate ブランチを切ります。

spkt branch start papers-2026-04        # → ingest/papers-2026-04
spkt branch start consolidate-2026-04   # → consolidate/2026-04

`spkt branch finish`¶

現在のブランチを main にfast-forwardマージして削除します。 main や ingest//consolidate/ 以外のブランチでは動作を拒否します。

`spkt branch abandon`¶

現在のブランチを破棄して main に戻ります。finish と同じガード付き。

`spkt history`¶

直近のBrainコミット一覧を表示します（git log ラッパー）。

spkt history -n 20
spkt history --grep ingest
spkt history --json

`spkt undo`¶

git revert でコミットを打ち消します。履歴は書き換えず保存されます。

spkt undo                               # HEADをrevert（確認あり）
spkt undo --to <sha>                    # <sha>以降をすべてrevert
spkt undo --ingest-tag papers-2026-04   # ingest(papers-2026-04)タグの一括取り消し
spkt undo -y                            # 確認をスキップ

git管理を使わない場合は spkt init --no-git、または .spikuit/config.toml に [git] auto_commit = false を指定してください。

非推奨コマンド¶

旧コマンドもまだ動きますが、stderrに非推奨の警告が出ます。上のリソース指向形式への移行をお勧めします。

旧コマンド	新コマンド
`spkt add`	`spkt neuron add`
`spkt list`	`spkt neuron list`
`spkt inspect`	`spkt neuron inspect`
`spkt fire`	`spkt neuron fire`
`spkt due`	`spkt neuron due`
`spkt link`	`spkt synapse add`
`spkt learn`	`spkt source ingest`
`spkt refresh`	`spkt source refresh`
`spkt communities`	`spkt community list` / `spkt community detect`

CLIリファレンス¶

グローバルオプション¶

Brain管理¶

spkt init¶

spkt config¶

spkt embed-all¶

Neuronコマンド¶

spkt neuron add¶

spkt neuron list¶

spkt neuron inspect¶

spkt neuron remove¶

spkt neuron merge¶

spkt neuron due¶

spkt neuron fire¶

Synapseコマンド¶

spkt synapse add¶

spkt synapse list¶

spkt synapse weight¶

spkt synapse remove¶

Sourceコマンド¶

spkt source ingest¶

spkt source list¶

spkt source inspect¶

spkt source update¶

spkt source refresh¶

Domainコマンド¶

spkt domain list¶

spkt domain rename¶

spkt domain merge¶

spkt domain audit¶

Communityコマンド¶

spkt community detect¶

spkt community list¶

検索¶

spkt retrieve¶

復習¶

spkt quiz¶