cli-anything-mubu は何をしますか？
Mubuライブブリッジのための正規パッケージ化エントリポイント。
インストール
このCLIは、正規の agent-harness ソースツリーからパッケージ化されています：
pip install -e .
前提条件:
- Python 3.10+
- このマシン上のアクティブなMubuデスクトップセッション
- CLIが利用可能なローカルのMubuプロファイルデータ
- 引数なしのデイリーヘルパーを使用する場合は
MUBU_DAILY_FOLDERを設定してください
エントリポイント
cli-anything-mubu
python -m cli_anything.mubu
サブコマンドなしで呼び出された場合、CLIはインタラクティブなREPLセッションを開始します。
コマンドグループ
Discover
フォルダ、ドキュメント、最近のアクティビティ、および日次ドキュメントの解決のための発見コマンド。
| コマンド | 説明 |
|---|
| docs | ローカルバックアップから既知の最新のドキュメントスナップショットを一覧表示します。 |
| folders | ローカルのRxDBストレージからフォルダメタデータを一覧表示します。 |
| folder-docs | 1つのフォルダのドキュメントメタデータを一覧表示します。 |
| path-docs | 1つのフォルダパスまたはフォルダIDのドキュメントを一覧表示します。 |
| recent | バックアップ、メタデータ、および同期ログを使用して、最近アクティブだったドキュメントを一覧表示します。 |
| daily | Dailyスタイルのフォルダを見つけ、その中のドキュメントを一覧表示します。 |
| daily-current | 1つのDailyスタイルのフォルダから現在の日次ドキュメントを解決します。 |
Inspect
ツリービュー、検索、リンク、同期イベント、およびライブノードターゲティングのための検査コマンド。
| コマンド | 説明 |
|---|
| show | 1つのドキュメントの最新のバックアップツリーを表示します。 |
| search | 最新のバックアップから一致するノードテキストまたはメモ内容を検索します。 |
| changes | ローカルログから最近のクライアント同期変更イベントを解析します。 |
| links | 1つのドキュメントバックアップから発信Mubuドキュメントリンクを抽出します。 |
| open-path | 完全パス、サフィックスパス、タイトル、またはドキュメントIDでドキュメントを開きます。 |
| doc-nodes | ノードIDと更新ターゲットパスを含むライブドキュメントノードを一覧表示します。 |
| daily-nodes | 1つのステップで現在の日次ドキュメントからライブノードを一覧表示します。 |
Mutate
Mubu APIに対するドライラン・ファーストのアトミックライブ編集のための変更コマンド。
| コマンド | 説明 |
|---|
| create-child | ライブMubu APIに対する子ノード作成を構築または実行します。 |
| delete-node | ライブMubu APIに対するノード削除を構築または実行します。 |
| update-text | ライブMubu APIに対するテキスト更新を構築または実行します。 |
Session
現在のドキュメント/ノードコンテキストとローカルコマンド履歴のためのセッションおよび状態コマンド。
| コマンド | 説明 |
|---|
| status | 現在のセッション状態を表示します。 |
| state-path | セッション状態ファイルのパスを表示します。 |
| use-doc | 現在のドキュメント参照を永続化します。 |
| use-node | 現在のノード参照を永続化します。 |
| use-daily | 現在の日次ドキュメント参照を解決して永続化します。 |
| clear-doc | 現在のドキュメント参照をクリアします。 |
| clear-node | 現在のノード参照をクリアします。 |
| history | セッション状態に保存された最近のコマンド履歴を表示します。 |
推奨エージェントワークフロー
discover daily-current '<daily-folder-ref>' --json
->
inspect daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
->
session use-doc '<doc_path>'
->
mutate update-text / create-child / delete-node --json
->
--execute only after payload inspection
安全ルール
- エージェント使用にはグループ化されたコマンドを推奨します。フラットなレガシーコマンドは互換性のために残されています。
- エージェントが出力を解析する場合は常に
--jsonを使用してください。 - 任意の
mutateコマンドの前にdiscoverまたはinspectコマンドを使用することを推奨します。 - ライブ変更はデフォルトでドライランであり、
--executeを指定した場合のみ実行されます。 - テキストマッチングよりも
--node-idと--parent-node-idを使用することを推奨します。 delete-nodeは対象となる完全なサブツリーを削除します。- 同じテキストへの更新でも、ドキュメントのバージョン履歴が進む可能性があります。
- 引数なしのデイリーヘルパーを使用する前に、日次フォルダ参照を明示的に渡すか、
MUBU_DAILY_FOLDERを設定してください。
例
インタラクティブREPLセッション
永続的なドキュメントとノードコンテキストを使用してインタラクティブセッションを開始します。
cli-anything-mubu
# コマンドをインタラクティブに入力
# 組み込みコマンドを見るには 'help' を使用
# sessionコマンドを使用して current-doc/current-node を永続化
現在の日次ノートを発見
明示的なフォルダ参照から現在の日次ノートを解決します。
cli-anything-mubu --json discover daily-current '<daily-folder-ref>'
ドライランアトミック更新
ライブ変更の前に、実際に送信されるペイロードを検査します。
cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'new text' --json
セッション状態
CLIはJSONで軽量なセッション状態を維持します：
current_doccurrent_node- ローカルコマンド履歴
session コマンドグループを使用して、この状態を検査または更新します。
AIエージェント向け
mutateではなくdiscoverまたはinspectから始めてください。session status --jsonを使用して永続化されたコンテキストを復元します。- 生成されたプロンプトや自動化ではグループ化されたコマンドを使用してください。
- ライブ変更の後は事後条件を検証してください。
- より厳密な操作詳細が必要な場合は、パッケージの
TEST.mdとREADME.mdを読んでください。
バージョン
0.1.1