@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 + operator chat + 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
mu chat                    # Interactive operator chat
mu chat --message "..."    # One-shot chat turn

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 (chat + web UI)
mu serve --no-open    # Don't open browser
mu serve --port 8080  # Custom port

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

In headless environments, it provides SSH port forwarding instructions.

Operator chat defaults

mu serve's attached terminal chat uses the same extension stack as mu chat and inherits .mu/config.json defaults from control_plane.operator.provider/model when present.

Standalone mu chat can still be overridden explicitly via flags:

mu chat --provider openai-codex --model gpt-5.3-codex

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.