@toolbeltai/cli

One-command installer for Toolbelt — drops an MCP server + agent skills into your AI tool.

Install

npx @toolbeltai/cli

That's it. Auto-detects Claude Code / Claude Desktop, writes the MCP config, installs the Toolbelt skills, and hands you a ready-to-use agent. No account required for the first 1K calls.

Commands

npx @toolbeltai/cli                       # install (default)
npx @toolbeltai/cli auth login            # claim/upgrade via browser
npx @toolbeltai/cli whoami                # show tier + limits
npx @toolbeltai/cli uninstall             # remove the MCP entry

Flags

--token <tb_xxx>     use an existing token instead of onboarding
--host <url>         self-hosted Toolbelt
--client <id>        override auto-detect (claude-code, claude-desktop, print)
--no-skills          skip the skills install
--dry-run            print the plan, don't write anything

Environment

TOOLBELT_TOKEN=tb_xxx      # forces use of this token (CI-friendly)
TOOLBELT_HOST=https://...  # self-hosted instance

How it works

1. Resolves a token in this order: --token flag, TOOLBELT_TOKEN env, ~/.toolbelt/config.json, otherwise a fresh POST /onboard.
2. Detects the best available MCP client; falls back to printing manual config if none is found.
3. Atomically writes the MCP server entry to the client's config file (a .toolbelt-backup is kept on first modification).
4. Downloads a pinned release of toolbelt-skills into the detected client's skills dir (e.g. ~/.claude/skills/, ~/.openclaw/skills/) for clients that support slash commands.

Auth

• Interactive machines: auth login opens your browser, you sign in on toolbelt.ai, the token is posted back to a short-lived local server (same pattern as gh auth login).
• Headless / CI: set TOOLBELT_TOKEN or pass --token.

License

MIT