cli-anything-mubu
Canonical packaged entrypoint for the Mubu live bridge.
Installation
This CLI is packaged from the canonical
source tree:
Prerequisites:
- Python 3.10+
- An active Mubu desktop session on this machine
- Local Mubu profile data available to the CLI
- Set if you want no-argument daily helpers
Entry Points
bash
cli-anything-mubu
python -m cli_anything.mubu
When invoked without a subcommand, the CLI enters an interactive REPL session.
Command Groups
Discover
Discovery commands for folders, documents, recency, and daily-document resolution.
|
| List latest known document snapshots from local backups. |
|
| List folder metadata from local RxDB storage. |
|
| List document metadata for one folder. |
|
| List documents for one folder path or folder id. |
|
| List recently active documents using backups, metadata, and sync logs. |
|
| Find Daily-style folders and list the documents inside them. |
|
| Resolve the current daily document from one Daily-style folder. |
Inspect
Inspection commands for tree views, search, links, sync events, and live node targeting.
|
| Show the latest backup tree for one document. |
|
| Search latest backups for matching node text or note content. |
|
| Parse recent client-sync change events from local logs. |
|
| Extract outbound Mubu document links from one document backup. |
|
| Open one document by full path, suffix path, title, or doc id. |
|
| List live document nodes with node ids and update-target paths. |
|
| List live nodes from the current daily document in one step. |
Mutate
Mutation commands for dry-run-first atomic live edits against the Mubu API.
|
| Build or execute one child-node creation against the live Mubu API. |
|
| Build or execute one node deletion against the live Mubu API. |
|
| Build or execute one text update against the live Mubu API. |
Session
Session and state commands for current document/node context and local command history.
|
| Show the current session state. |
|
| Show the session state file path. |
|
| Persist the current document reference. |
|
| Persist the current node reference. |
|
| Resolve and persist the current daily document reference. |
|
| Clear the current document reference. |
|
| Clear the current node reference. |
|
| Show recent command history stored in session state. |
Recommended Agent Workflow
text
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
Safety Rules
- Prefer grouped commands for agent use; flat legacy commands remain for compatibility.
- Use whenever an agent will parse the output.
- Prefer or commands before any command.
- Live mutations are dry-run by default and only execute with .
- Prefer and over text matching.
- removes the full targeted subtree.
- Even same-text updates can still advance document version history.
- Pass a daily-folder reference explicitly or set before using no-arg daily helpers.
Examples
Interactive REPL Session
Start an interactive session with persistent document and node context.
bash
cli-anything-mubu
# Enter commands interactively
# Use 'help' to see builtins
# Use session commands to persist current-doc/current-node
Discover Current Daily Note
Resolve the current daily note from an explicit folder reference.
bash
cli-anything-mubu --json discover daily-current '<daily-folder-ref>'
Dry-Run Atomic Update
Inspect the exact outgoing payload before a live mutation.
bash
cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'new text' --json
Session State
The CLI maintains lightweight session state in JSON:
Use the
command group to inspect or update this state.
For AI Agents
- Start with or , not .
- Use to recover persisted context.
- Use grouped commands in generated prompts and automation.
- Verify postconditions after any live mutation.
- Read the package and when stricter operational detail is needed.
Version
0.1.1