Command-line interface for Mubu - Canonical packaged entrypoint for the Mubu live bridge....

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

cli-anything-mubu