What are the prerequisites for using this CLI?

You need Python 3.10 or higher, an active Mubu desktop session, and local Mubu profile data.

How do I start using the CLI for Mubu?

After installation, you can start the CLI by running `cli-anything-mubu` in your terminal.

What types of commands can I execute with this CLI?

You can execute commands for discovering documents, inspecting document details, and mutating document content.

Is there a way to preview changes before applying them?

Yes, all mutation commands perform a dry-run by default, allowing you to inspect the outgoing payload before execution.

Can I maintain a session state while using the CLI?

Yes, the CLI maintains a lightweight session state in JSON, allowing you to persist your current document and node references.

CLI for Mubu

Name: CLI for Mubu
Availability: InStock
Author: hkuds

Free

Interact with Mubu through a command-line interface.

by hkuds46.9k stars on hkuds/cli-anything

2 views

Updated Aug 3, 2026

Get this skill

Free · Opens the source repo

What CLI for Mubu does

The CLI for Mubu provides a command-line interface designed for interacting with the Mubu live bridge. This tool is particularly useful for users who prefer a terminal-based approach to manage their Mubu documents and folders. By leveraging this CLI, users can execute a variety of commands to discover, inspect, and mutate their document structure in Mubu, all while maintaining a local session state.

Installation is straightforward, requiring Python 3.10 or higher and an active Mubu desktop session. Once set up, users can invoke the CLI to enter an interactive REPL session or execute specific commands directly. The command groups are well-structured into categories such as Discover, Inspect, and Mutate, allowing for organized access to functionalities like listing recent documents, searching for content, and performing live edits on documents.

The CLI emphasizes safety and efficiency with its dry-run feature for mutations, ensuring that users can inspect changes before they are applied. It also maintains a session state in JSON format, which allows users to persist their current document and node context across commands. This is particularly beneficial for users who need to perform multiple related operations in a single session without losing track of their progress.

Overall, the CLI for Mubu is tailored for developers and designers who utilize Mubu for document management and prefer a command-line interface for automation or scripting tasks. Its structured command groups and session management features make it a powerful tool for enhancing productivity in handling Mubu documents.

When to use it

Use this tool when you need to automate document management tasks in Mubu or prefer a terminal interface for your workflow.

When not to use it

This CLI is not suitable for users who are unfamiliar with command-line interfaces or those who prefer graphical user interfaces for managing documents.

What you can build with it

Automate Document Management

Use the CLI to automate repetitive tasks such as listing recent documents or synchronizing changes.

Interactive Document Inspection

Start an interactive REPL session to explore your documents and their metadata dynamically.

Perform Safe Live Edits

Utilize the dry-run feature to safely update or delete document nodes without immediate execution.

How to install CLI for Mubu

View source

1. Install with the skills CLI

npx skills add hkuds/cli-anything/skills --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by hkuds

cli-anything-mubu

Canonical packaged entrypoint for the Mubu live bridge.

Installation

This CLI is packaged from the canonical agent-harness source tree:

pip install -e .

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

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.

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

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 --json whenever an agent will parse the output.
Prefer discover or inspect commands before any mutate command.
Live mutations are dry-run by default and only execute with --execute.
Prefer --node-id and --parent-node-id over text matching.
delete-node removes the full targeted subtree.
Even same-text updates can still advance document version history.
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.

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.

cli-anything-mubu --json discover daily-current '<daily-folder-ref>'

Dry-Run Atomic Update

Inspect the exact outgoing payload before a live mutation.

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:

current_doc
current_node
local command history

Use the session command group to inspect or update this state.

For AI Agents

Start with discover or inspect, not mutate.
Use session status --json to recover persisted context.
Use grouped commands in generated prompts and automation.
Verify postconditions after any live mutation.
Read the package TEST.md and README.md when stricter operational detail is needed.

Version

0.1.1

Frequently asked questions about CLI for Mubu

Similar skills

Agent-Browser Core

Efficient browser automation for AI agents.

Setup My IQ

Effortlessly create and update your personal context portfolio.

CRM Maintenance

Automate HubSpot updates from your calendar and emails.

Zoom MCP

Streamline access to Zoom meeting assets and recordings.

Slack Automation

Automate tasks and extract data from Slack easily.

SMB Onboard

Guides small business owners through initial tool setup.