Skip to content
axonpush Docs

axonpush Wizard

The axonpush wizard is a thin launcher that hands integration off to whichever AI coding agent you already have on PATH. The actual integration logic lives as a cross-agent skill bundle — axonpush/skills — installable into 50+ agents (Claude Code, Cursor, Codex, OpenCode, Cline, GitHub Copilot, Windsurf, Gemini, +40 others) via the universal skills.sh installer.

Quick Start

Section titled “Quick Start”
Terminal window
npx @axonpush/wizard

That’s it. Under the hood the launcher:

  1. Runs npx skills add axonpush/skills to install the AxonPush skill bundle into every agent it detects on the machine.
  2. Invokes the first AI coding agent it finds on PATH (claude, cursor, codex, …) so you land directly inside the agent with the skills already loaded.
  3. Asks the agent to run the axonpush-integrate skill, which detects your framework, walks you through credentials, and wires the SDK into your project.

Skip the launcher

Section titled “Skip the launcher”

You don’t have to use the wizard. The skills are the product — install them however you prefer:

Terminal window
# Universal cross-agent installer (works with 50+ agents)
npx skills add axonpush/skills
Terminal window
# Already inside Claude Code? Use the native plugin command:
/plugin install axonpush/skills

Once installed, ask your agent to run the axonpush-integrate skill (in Claude Code: /axonpush-integrate). Each framework also ships as its own invocable skill — see Supported Frameworks.

What the integrate skill does

Section titled “What the integrate skill does”

axonpush-integrate is a Markdown skill the agent follows step by step:

  1. Detect framework — scans pyproject.toml, requirements.txt, package.json, and source imports for LangChain, OpenAI Agents, CrewAI, Anthropic, LlamaIndex, Mastra, Vercel AI SDK, Google ADK, and others.
  2. Authenticate — runs a small helpers/login.sh that opens https://app.axonpush.xyz/wizard-auth?port=N in your browser, listens on 127.0.0.1:N, and reads api_key + tenant_id from the redirect. Manual paste is also supported for headless / SSH sessions. See Browser Auth.
  3. Provision — calls the AxonPush API to create an app and a default channel for the project.
  4. Wire it in — installs the SDK, writes credentials to .env, and adds the framework integration code to your entry point.

Existing code is never removed — only AxonPush integration code is added.

Why the launcher still exists

Section titled “Why the launcher still exists”

Muscle memory. npx @axonpush/wizard is the one-liner that has been on the README, the marketing site, and our HN posts for a year. Keeping it as a 35-line shim around skills add axonpush/skills means external links and shell history keep working while the real integration logic lives in the host-agnostic skill bundle.

Source

Section titled “Source”