概要と現在地Hands-on導入ガイドコマンドリファレンスアーキテクチャConcept RuntimeKnowledge SocietyKnowledge Card / 評価Knowledge FieldKnowledge GraphDistiller / RunPodSecurity / Trust BoundaryOperations差分と取り込み管理者ガイド
COMMANDS
コマンドリファレンス
公開CLIの現行基準は v1.5.92 です。Knowledge Societyの管理操作は、認証済みの murasamed へ送られ、CLIから共有DBへ直接接続しません。
対話
murasame | TUI を起動して対話する(基本の使い方) |
murasame ask [質問] | 1 問だけ投げて回答を表示して終了。標準入力のパイプ受け取りに対応 |
murasame exec <タスク> | タスクを一文で渡して shell 込みで自走させる(セルフホスト開発向け) |
git diff | murasame ask この変更のレビューをして
murasame ask "ログの要約" < server.log対話の中で「画像を作って」「図を描いて」と頼むと、画像生成モデルへ自動的にルーティングされます。
自然言語からConcept Runtimeへ
「社内のタスク管理システムを設計したい」のように、仕様・設計・要件・業務フローを作る意図を含む入力は、通常TUIからConcept Runtimeへ自動分岐します。通常の質問やコード修正は通常会話のままです。確認質問には y / n で答え、最終承認後にだけConcept Modelを保存して実行・検証・成果物生成を行います。
/concept <要求> | 通常TUIからConcept Runtimeを明示的に開始 |
murasame concept run "要求" | CLIから自然言語→確認→実行→Rendererを開始 |
TUI のキー操作
Shift + Tab | モード切替(制約レベルなど) |
↑ / ↓ | 送信履歴の前後移動 |
Esc | 考え中の応答を中断 |
Ctrl + F | 過去の会話から検索して復元 |
アカウント
murasame login | ゲートウェイトークンで認証(端末に保存) |
murasame status | ローカル daemon / Gateway のhealth・readinessを診断(readinessは認証不要) |
murasame whoami | 現在の接続先・ランタイム・ユーザーを表示 |
murasame logout | 保存済みの資格情報を削除 |
murasame version | バージョンとビルドハッシュを表示 |
User Brain(個人記憶)
個人カードは端末の ~/.murasame/userbrain.db にのみ保存されます。サーバーには送信されません。
murasame brain stats | 個人カードの集計(件数・状態・由来) |
murasame brain list [--all] | 個人カードの一覧(--all で拒却・差し替え済みも表示) |
murasame brain extract [--full] | 会話履歴から持続的な傾向を抽出して候補カードを作成 |
murasame align [--limit N] | 候補カードを 1 件ずつ本人確認(確認/修正/棄却/後で) |
murasame brain promote <id> | 確認済みカードを一般化し、共有知識の候補(candidate)に昇格 |
murasame brain forget <id> | 個人カードを削除 |
典型的な流れ
murasame brain extract # 履歴から候補を抽出
murasame align # y=確認 / e=修正 / n=棄却 / s=後で
murasame # 確認済みのカードが推論に強く反映される修正(e)を選ぶと、正しい内容の新カードを作り、旧カードは履歴として残します(破棄しません)。 昇格できるのは本人確認済み(confirmed)のカードだけで、昇格後は共有側の自動評価フローに乗ります。
Knowledge Graph
Graph操作はProject / GlobalのSQLite Storeを対象にします。自然言語や外部解析の結果はProposalとして保存し、approveするまでGraphへ確定適用しません。
murasame kg init [projectId] | Project KGを初期化。--globalでGlobal KG |
murasame kg demo [projectId] | ブログの自然言語→Graph→Spec→Code実験 |
murasame kg propose <projectId> "要求" | 自然言語からGraph変更Proposalを作成(--approve可) |
murasame kg dialogue <projectId> "発言" | 1ターン処理、Graph preview、次の質問 |
murasame kg questions <projectId> | Global Knowledgeから不足論点を表示 |
murasame kg status [projectId] | Node / Edge / pending Proposalの状態 |
murasame kg approve <proposalId> | Proposalを承認してGraphへ適用 |
murasame kg reject <proposalId> | Proposalを却下 |
murasame kg spec <projectId> [--out file] | GraphからMarkdown仕様書を生成 |
murasame kg generate <projectId> [--write] | Next.jsのレビュー用最小Skeletonを生成 |
murasame kg snapshot <projectId> [--out file] | 揮発時刻を除いたGit向けSnapshot |
murasame kg neighbors <projectId> <nodeId> | 近傍Nodeをboundedに表示(--depth / --limit / --json / --tui) |
murasame kg path <projectId> <fromId> <toId> | 有向最短経路とRelationsを表示(--json / --tui) |
murasame kg reachable <projectId> <fromId> <toId> | 有向到達可否を判定(--json) |
murasame kg adapters | Graph Adapterの実装状態(SQLite/InMemoryと未接続外部Adapter) |
murasame kg sync-diff <projectId> <snapshot> | Snapshot差分とconfirmed競合をread-only表示 |
murasame kg sync-propose <projectId> <snapshot> | 差分をproposed/unverified Proposalへ変換 |
murasame kg complete <projectId> "意図" [--provider deterministic|llm] | 任意ドメインの候補をProposal化。LLMはOpenAI互換provider設定時のみ |
murasame kg promote-cards <projectId> <cards.json> --confirm ... | Evidence・approved Human Review済みCardだけをGraphへ昇格 |
murasame kg init blog
murasame kg dialogue blog "一般ユーザー登録は不要。管理者がAuthorを作る"
murasame kg questions blog
murasame kg spec blog --out spec.md
murasame kg generate blog --write --out generated
murasame kg neighbors blog <nodeId> --depth 2 --tui
murasame kg path blog <fromId> <toId> --jsonKnowledge Field — read-only Scope / TUI
murasame kg scope <projectId> | Local / Globalのbounded Scopeをtext表示。DBはreadonlyで開く |
murasame kg scope <projectId> --json | 揮発値を含まない決定的なJSON snapshotを出力 |
murasame kg scope <projectId> --tui | Sixel / Kitty画像層、またはANSI / Unicodeへフォールバックする全画面TUI |
murasame kg scope <projectId> --tui --actions | I/C/Xを明示したときだけProposalまたはLedgerを作る。既定はread-only |
murasame kg field-action <projectId> request.json | IMPORT/CREATEをpending Proposal、IGNOREをLedgerへ記録 |
--tuiは選択・詳細・Relationsの観測だけを行います。--actionsを明示した場合だけ、確認キーY後にIMPORT/CREATEをpending Proposal、IGNOREをLedgerへ記録します。approve、CardやNodeの昇格、Global共有は行いません。--jsonと同時には指定できません。
外部Graph / Card / Distillerの取り込み
murasame kg export <projectId> [--out file] | Understand-Anything互換JSON Viewを出力(--domain可) |
murasame kg import-ua <projectId> <file> | Understand-Anything JSONをProposalとして取り込む |
murasame kg analyze <projectId> [--root dir] | ソースからReverse Analysis候補を作成 |
murasame kg import-codegraph <projectId> <db> | CodeGraph DBを読み取り専用で取り込む |
murasame kg import-distiller <parsed.jsonl> | Distiller CandidateをGlobal KG Proposalへ変換 |
murasame kg evolve-cards <file> | Knowledge Card JSONからGraph進化候補を作成 |
murasame kg evolve-cards --query "語" | 既存Cardの検索結果から進化候補を作成 |
これらは既定で proposed / unverified です。取り込み成功やProposalの承認はKnowledgeの正しさを意味しないため、Evidence・評価・人間レビューを別に確認します。Card進化とSnapshot同期も、既存confirmed資産を自動上書きしません。
Distiller / RunPod
LLM-jpの蒸留はPython側で実行します。ローカルのMockはテスト用で、本線はRunPod 48GB級GPUです。
cd distiller
uv run python distill.py window --topic "分散システムの設計" --duration 3h --runpod --resume --db data/global-distiller.db --output-dir data/distillerWindow RunnerはParsed JSONL取得後にGraph Bridgeを自動実行します。確定Cardへの自動昇格はありません。 継続判断のメトリクスと運用は /docs/distiller を参照してください。
運用コマンド(管理者の環境のみ)
以下のコマンドは共有の知識データベースに直結するため、MURASAME_ADMIN=1 が設定された運用ホストでのみ実行できます。通常の端末では起動が拒否されます。
eval — 知識カードの自動評価
murasame eval card <id> | 1 件を評価してスコアと判定を表示(--json / --force 対応) |
murasame eval pending [--limit N] [--promote] | 未評価の candidate を順に評価。--promote で合格を即昇格 |
murasame eval promote <id> | 最新の評価が pass のカードを verified に昇格 |
murasame eval stats | 判定分布・平均スコア・未評価の残数 |
評価は複数の LLM judge による合議で行われ、全員 pass のみ verified、 1 件でも reject があれば却下、割れた場合は disputed として人の確認に回ります。 未変更のカードは再評価されません(冪等)。
domain / ingest / card — 知識ドメインと法令 ingest
murasame domain seed | list | inspect <slug> | ドメイン階層の投入・一覧・詳細 |
murasame ingest run <slug> | 法令を条単位で ingest(candidate 化)。--max-laws N / --title / --dry-run / --evaluate N |
murasame card relations <cardId> | カードの関係(contains / cites など)を表示 |
review — 専門家レビュー(Excel)
murasame review batch create [--domain <slug>] [--size N] | レビュー用バッチを作成 |
murasame review batch export <batchId> [--out <path>] | Excel に書き出し |
murasame review batch import <file> | 記入済み Excel を取り込み(冪等) |
murasame review batch list | バッチ一覧 |
harvest — 外部エージェント / LLM による調査
murasame harvest create --domain <slug> --objective "..." | 調査 job を作成(--harvester agy|llm-gen) |
murasame harvest run <jobId> | job を実行 |
murasame harvest status [jobId] | job 一覧 / 詳細 |
murasame harvest findings <jobId> | 検証済みの知見を表示 |
society — Persona 社会の観測
常駐ループはdaemon側で MURASAME_SOCIETY=1 を明示したときだけ動きます。 CLIを終了してもJobとCouncilはdaemon側に残ります。OpenCode / Coding Planを使う場合は、同一ホスト上のSocietyとカード評価Workerで呼び出し間隔を共有します。
murasame society stats | status | Persona、Council、Claim、Candidate、Job、Runtimeの統計 |
murasame society runtime status | Simulation Clockとpause状態を表示 |
murasame society runtime pause|resume | 社会時間のJob処理を停止・再開 |
murasame society personas list | show <id> | Persona一覧・記憶・信念を表示 |
murasame society council enqueue|run|pipeline "..." | daemon上でCouncilを投入・実行・調査・Candidate評価 |
murasame society council research <id> | Councilの調査Jobを投入 |
murasame society council list | show <id> | Council一覧・参加者・発言・主張を表示 |
murasame society claims|questions|candidates|jobs list | Knowledge Societyの生成物・再開可能なJobを表示 |
murasame society candidate assess <id> | Candidateの昇格条件を評価 |
murasame society candidate verify <id> --spec <file> | Candidateに紐付く実地検証を実行 |
murasame society candidate materialize <id> --human-reviewed | 人手確認済みCandidateをcandidate cardへ物質化 |
murasame society memory consolidate <personaId> | Personaの記憶候補を統合 |
murasame society debate start <cardId> | カードを起点に討論を開始 |
murasame society debate list | show <id> | 討論一覧・発言ログ |
murasame society seed occupations --per-occupation N | 職種原型からPersonaを生成 |
# Coding Planを使うdaemonの例
MURASAME_SOCIETY=1
MURASAME_SOCIETY_PLAYERS=opencode
MURASAME_OPENCODE_MODEL=zai-coding-plan/glm-5.3
# 既定60秒。厳しい制限ではさらに大きくする
MURASAME_OPENCODE_MIN_INTERVAL_MS=60000Candidateの物質化には --human-reviewed が必要です。議論の合意だけでVerified Knowledgeへ昇格するコマンドはありません。
利用状況とプロバイダ
murasame usage | codex アカウントの利用状況とブロック状態を表示 |
murasame provider <connect | status | disconnect> | ChatGPT Web 連携のプロバイダ接続を管理 |
murasamed | ソースビルド済みのローカル daemon を起動(公開installには含まれない) |
Private Deployment導入契約
murasame private validate <config.json> | Private Knowledge、Runtime、egress、Review、rollback条件を検証 |
murasame private plan <config.json> | deterministic導入計画とresource/gate/audit契約を出力 |
murasame private apply <config.json> --confirm APPLY:... | local manifestとhash-chain監査だけを記録。実GPU provisioningはしない |
murasame private rollback <config.json> --confirm ROLLBACK:... | 破壊的削除なしのrollback要求を監査ログへ記録 |
murasame private validate docs/private-deployment.example.json
murasame private validate docs/private-deployment.example.json --json
murasame private plan docs/private-deployment.example.json --json
murasame private apply docs/private-deployment.example.json --confirm APPLY:<deploymentId>:<planId>
murasame private rollback docs/private-deployment.example.json --confirm ROLLBACK:<deploymentId>:<planId>:<rollbackToken>これは導入条件の契約チェックです。GPU provisioning、SLA、監査認証、完全自動デプロイを提供済みとは扱いません。
Knowledge Pack
murasame pack validate <pack.json> | schema、content hash、Ed25519署名、Provenance、Human Review、rollback、Private Deployment境界を検証 |
murasame pack inspect <pack.json> | 検証済みPackの内容・系譜・レビュー・配信契約をread-only表示 |
Packの外部配信、Import、Globalへの無確認共有、Provisioningは実行しません。検証済みであることと、利用環境へ配信済みであることは別です。