@femtomc/mu

mu is a personal agent for technical work.

This package provides the Bun CLI and programmatic API.

Install

After publishing:

npm install -g @femtomc/mu
# or: bun add -g @femtomc/mu

From this repo:

cd mu
bun install
bun run build
packages/cli/dist/cli.js --help

Usage

CLI Commands

mu serve                   # Start server + terminal operator session + web UI (auto-inits .mu)
mu status                  # Show repository status
mu issues list             # List all issues
mu issues create "title"   # Create new issue
mu issues ready            # Show ready leaf issues
mu forum post topic -m "message"  # Post to forum
mu run "goal..."           # Run orchestration loop (auto-inits .mu)
mu resume <root-id>        # Resume interrupted run

Programmatic API

import { run } from "@femtomc/mu";

const r = await run(["status", "--json"]);
if (r.exitCode !== 0) throw new Error(r.stdout);
console.log(r.stdout);

Web UI

The mu serve command starts the server with the bundled web UI and immediately attaches an interactive terminal operator session in the same shell:

mu serve              # Default port: 3000 (operator session + web UI)
mu serve --no-open    # Don't open browser
mu serve --port 8080  # Custom port

Type /exit in the operator prompt (or press Ctrl+C) to stop both operator session and server.

In headless environments, it provides SSH port forwarding instructions.

Operator session defaults

mu serve's attached terminal operator session inherits .mu/config.json defaults from control_plane.operator.provider/model when present. Commands issued in the terminal session route through the control plane pipeline via /api/commands/submit.

Use mu control status to inspect current config-driven control-plane/operator state.

Tests / Typecheck

From the mu/ repo root:

bun test packages/cli
bun run typecheck

Runtime

• Bun runtime (ESM).
• Reads/writes a .mu/ store at the git repo root.