@axon-corp/launchpad-cli

Push prototypes to Axon Launchpad from the command line.

Built for non-technical Axon employees who are prototyping locally with Claude Code or Cursor — say "Add to Launchpad" and let the agent run launchpad push for you.

Quick start

# One-time: generate a personal access token at
#   https://launchpad.apps.axon.com/settings/tokens
# then sign in to the CLI:
npx @axon-corp/launchpad-cli login

# Push the current directory:
npx @axon-corp/launchpad-cli push

# That's it. Subsequent `launchpad push` calls update the same project.

Commands

| Command | What it does | |---|---| | launchpad login | Prompt for your personal access token; store it under ~/.launchpad/config.json (0600). Pass --token <token> to sign in non-interactively (e.g. when an AI agent logs in on your behalf), or --stdin to read the token from stdin. | | launchpad logout | Forget the stored token. | | launchpad push [path] | Zip the current (or specified) directory and deploy. First push creates a new project; subsequent pushes update the same slug. | | launchpad list | List the prototypes you own. | | launchpad status <deploymentId> | Poll a deployment until it finishes. | | launchpad open | Open the current project's deployed URL in your browser. |

How it knows which Launchpad project a folder maps to

After your first push, the CLI writes .launchpad.json to your project root:

{
  "slug": "my-prototype",
  "projectId": "prj_…",
  "lastDeployedAt": 1716333000000
}

Subsequent pushes read that file and update the same slug. If the file is missing the CLI prompts for a name and creates a new project. If the slug has been reassigned away from you, the CLI offers to push as a new project instead of failing silently.

Add .launchpad.json to your .gitignore (or commit it — it doesn't contain secrets, just identifiers).

Environment

| Variable | Purpose | |---|---| | LAUNCHPAD_URL | Override the Launchpad base URL (defaults to https://launchpad.apps.axon.com). Useful for staging / local dev. | | LAUNCHPAD_TOKEN | Override the stored PAT for a single invocation. CI usage. |

License

Internal — Axon employees only.