Linzumi

▓▓╗     ▓▓╗▓▓▓╗   ▓▓╗▓▓▓▓▓▓▓╗▓▓╗   ▓▓╗▓▓▓╗   ▓▓▓╗▓▓╗
▓▓║     ▓▓║▓▓▓▓╗  ▓▓║╚══▓▓▓╔╝▓▓║   ▓▓║▓▓▓▓╗ ▓▓▓▓║▓▓║
▓▓║     ▓▓║▓▓╔▓▓╗ ▓▓║  ▓▓▓╔╝ ▓▓║   ▓▓║▓▓╔▓▓▓▓╔▓▓║▓▓║
▓▓║     ▓▓║▓▓║╚▓▓╗▓▓║ ▓▓▓╔╝  ▓▓║   ▓▓║▓▓║╚▓▓╔╝▓▓║▓▓║
▓▓▓▓▓▓▓░░░░░░░░╚▓▓▓▓║▓▓▓▓▓▓▓╗╚▓▓▓▓▓▓╔╝░░░░░░░░▓▓║▓▓║
╚═══▒▒▒@@@@@@@@▒▒═══╝╚══════╝ ╚════▒▒▒@@@@@@@@▒▒╝╚═╝
 ▒@@@@@@@@@@@@@@@@▒             ▒@@@@@@@@@@@@@@@@▒
@@@@@@@@@@@@@@@@@@@@@           @@@@@@@@@@@@@@@@@@@@@
   @@@@@@@@@@@@@@@                 @@@@@@@@@@@@@@@
          ║║                             ║║
          ║║                             ║║
          ║║        ()-().----.          ║║
          ║║         \"/` ___  ;_________║║_.'
          ║║          ` ^^   ^^          ║║
──────────╨╨─────────────··────··────────╨╨──────────────
secure mission control for all your agents on your computers

Linzumi is a lightweight, Slack-like chat built for native AI Engineering teams. Your coding agents run on your computer, reach you in your browser or on your phone, and build context for your team about what's going well, what's blocked, and what's ready to ship. Ship more, regret less.

Try it

Paste this into your terminal:

npx -y @linzumi/cli@latest signup

Linzumi will ask for your email, send you a sign-in code, help you pick the repos where Codex may work, start useful first tasks, and open Mission Control in your browser with the work already running.

Why a CLI

Your agent runs on the laptop you trust, with your real env vars, your real dotfiles, and your real branches. No "works in the sandbox VM, breaks in your repo" surprises. The chat side runs in your browser; the work side runs locally. This npm package is the local half.

What you'll have in three minutes

• A Linzumi workspace in your browser.
• A local Commander connected to one trusted project folder.
• A live Coding agent thread your team can watch and steer.
• Optional browser editor and preview forwarding for the running app.

Manual Runner Setup

Install the CLI or run it with npx:

npm install -g @linzumi/cli@latest
npx -y @linzumi/cli@latest signup
npx -y @linzumi/[email protected] --version
linzumi --version

Start a local runner from a trusted folder:

linzumi paths add ~/code/my-app
linzumi start ~/code/my-app

For explicit runner roots, pass a comma-separated allowlist:

linzumi start ~/code/my-app --allowed-cwd <paths>

For non-production Linzumi servers, connect accepts either API URL flag:

linzumi connect --linzumi-url ws://127.0.0.1:4140 --workspace default --allow-port-forwarding-by-default

Agent-first launch path

The fastest path is the npx -y @linzumi/cli@latest signup command above. It signs you in, lets you trust local projects, connects the Commander, and starts the first visible Coding agent threads.

What just happened

Linzumi keeps the browser/chat surface separate from the local work surface. The CLI authenticates your local Commander, publishes runner capabilities, and lets Kandan ask that Commander to start Codex inside trusted folders only.

MCP for coding agents

Commander-started Codex sessions are preconfigured with a local MCP server named linzumi. It lets the agent use the same approved local-runner auth to read the scoped Linzumi message, thread, or channel context, and to send a bounded DM to the Commander owner when configured.

Manual MCP commands are available for other MCP-compatible agents:

linzumi mcp doctor --api-url https://serve.linzumi.com --workspace <workspace> --channel <channel>
linzumi mcp config --api-url https://serve.linzumi.com --format codex
linzumi mcp config --api-url https://serve.linzumi.com --format claude-code
linzumi mcp server --api-url https://serve.linzumi.com

The shipped tools are linzumi_get_message, linzumi_get_thread, linzumi_get_channel, and linzumi_dm_owner.

Three things to try first

• Ask the Coding agent to make a small UI change and watch the thread.
• Open the browser editor from the thread controls.
• Share the preview URL with a teammate or your phone.

Working as a team

Use the Linzumi thread as the shared source of truth. Humans can reply, steer, interrupt, or inspect output while the actual commands still run on the trusted local machine.

Trusted folders

Linzumi only edits inside folders you've explicitly trusted.

linzumi paths add ~/code/my-app

The trust list lives at ~/.linzumi/config.json. The bootstrap agent adds /tmp/hello_linzumi for you on first run. For linzumi connect, the selected --cwd is also trusted for that runner process.

When something looks wrong

Run linzumi --help or reconnect with linzumi start ~/code/my-app. If the browser says no runner is connected, check that the terminal running the Commander is still open and that the folder is listed in ~/.linzumi/config.json.

Slack-shaped on the surface. A multiplayer compiler underneath.

linzumi.com · agents.md ·