CLI

kura <command> [options]。コマンド一覧は kura --help、各コマンドの フラグは kura <command> --help で確認できます。

共通の作法

• --json — すべての読み取りコマンドは、整形テキストの代わりに 機械可読な JSON を出力できます。スクリプト向けで、 MCP サーバー からも利用されます。
• ドキュメントの指定 — ドキュメントを取るコマンドは、doc key・ #key・フルパス（db/sqlite/メモ）・一意なタイトルを受け付けます （例: kura get "今日のメモ" や kura get #a1b2c3）。
• NO_COLOR — 設定すると色付き出力を無効にします。
• データの場所 — KURA_HOME はデータディレクトリ（既定 ~/.kura）を、KURA_DB は DB ファイルを上書きします。

セットアップと健全性

コマンド	内容
kura init	~/.kura の作成、トークナイザーのダウンロード、DB 作成
kura doctor	SQLite・拡張・LLM プロバイダ・DB 整合性を診断
kura doctor --fix	インデックス修復、孤立 GC、リンク再解決、embedding モデル変更の検出
kura status	ストアの統計（件数・embedding カバレッジ・陳腐化候補）
kura config list|get|set	~/.kura/config.toml の読み書き

ドキュメント

コマンド	内容
kura add <file>	追加。- で標準入力。--path / --tags / --title / --bucket
kura get <ref>	表示（Markdown または --json）
kura edit <ref>	$EDITOR で編集。frontmatter でタイトル・パス・タグも変更
kura rm <ref>	削除
kura mv <ref> [<title>]	リネームと移動（--path。相互リンクを書き換え）。--prefix <old> <new> でサブツリーを一括移動
kura mv suggest	未整理ドキュメントの path をリンク・タグ・検索シグナル（LLM があれば加えて）から提案。--apply / --json
kura ls	一覧。--tag / --bucket / --prefix / --sort / --stale
kura clip <url>	Web ページを LLM で整形して取り込み。clip.path（既定 clips）配下に保存
kura export --dir <d>	frontmatter 付き Markdown で書き出し。パスはサブディレクトリになる
kura import <dir>	kura_key でラウンドトリップ（更新 or 新規）。サブディレクトリはパスになる

検索

コマンド	モード	補足
kura search <q>	キーワード	FTS5 BM25。常に利用可能。< 100ms
kura vsearch <q>	セマンティック	ローカル embedding に対するベクトル KNN
kura query <q>	ハイブリッド	キーワード + ベクトルを融合し、ローカル LLM でリランク
kura embed	—	embedding が無いドキュメントを（再）生成

モードの違いと、LLM プロバイダが無いときの劣化動作は 検索 を参照してください。

整理

コマンド	内容
kura bucket ls|add|rm	Bucket を管理
kura tag ls	タグ一覧。--tree で階層表示
kura tag suggest	LLM によるタグ提案。--untagged / --apply（既存タグ体系を優先）
kura tag audit	類似タグの統合候補、巨大タグの警告
kura link ls <ref>	アウトリンク・バックリンク・2 ホップリンク
kura link broken	未解決の相互リンク一覧

サーバー

コマンド	内容
kura browser	http://127.0.0.1:7578 でブラウザ UI を提供
kura mcp	AI エージェント向けに stdio で MCP サーバーを起動
kura mcp --print-config	.mcp.json 用スニペットを表示

終了コード

コード	意味
0	成功
1	エラー（一意制約違反などの競合を含む）
2	使い方エラー（引数が不正）
3	見つからない（該当ドキュメントなし）
4	LLM プロバイダが利用不可

スクリプトはこれらに依存できます。終了コード 4 は「その機能は モデルを必要とし、どれにも到達できなかった」ことを意味し、通常の エラーとは区別されます。