alt
Developer Docs

Developer Docs

CLI

Set up Alt integrations from your terminal with one interactive setup wizard.

The altalt CLI guides you through MCP, REST API, and webhook setup without replacing existing configuration. Run it from the project directory you want to connect:

npx
npx altalt

Requires Node.js 18 or later. npx downloads the current CLI package for this run; no global install is required.

What the setup wizard does

  1. 1

    Connect MCP

    Detect Claude Code and Codex, offer Cursor setup, and connect the hosted Alt MCP server with browser OAuth. See MCP for manual client configuration.

  2. 2

    Verify API and webhooks

    Open the account console, validate the API key you paste, save it to the current project, and optionally send a confirmed test event to a selected webhook endpoint.

  3. 3

    Hand off the build

    After confirmation, give your coding agent a prompt backed by the machine-readable developer docs. If no supported agent is installed, the CLI prints the prompt for you to paste.

Modes and flags

--mcp-onlyLimit setup to MCP clients with browser OAuth, then offer agent handoff.
--api-onlyLimit setup to REST API and webhook verification, then offer agent handoff.
--print-promptPrint the coding-agent prompt and exit.
--devTarget the development stack. Use this only for pre-release QA.
--versionPrint the installed CLI version.
--helpPrint command usage and available flags.

Configuration and key safety

  • The CLI checks the key before changing an environment file and stores it as ALT_API_KEY in the current project directory.
  • Existing Alt MCP configurations are not deleted or overwritten. When necessary, OAuth is added alongside them as alt-oauth.
  • Agent handoff and webhook test delivery both require explicit confirmation. Review key handling in Security before deploying.

Current availability

The CLI package is public, but production OAuth and API-key issuance are currently limited to Alt administrators during dogfooding. Existing API-key MCP connections remain supported. If the console returns 404 or OAuth approval is unavailable, your account is not enabled yet.