Quickstart

The fastest way to build and deploy your first app with the Claude Code plugin

The fastest path is the Claude Code plugin. Install it, then just say what you want in plain language — it handles installation, login, creating an app, and deploying. Prefer the terminal? See the CLI method below.

What you need

A member account at a company that uses AxHub
A GitHub account
Claude Code (where the plugin runs)

Install the plugin

Enter these two lines in the Claude Code prompt, one at a time.

/plugin marketplace add jocoding-ax-partners/axhub
/plugin install axhub@axhub

Set up

Once it's installed, just say:

set up axhub

The plugin walks you through installing the CLI → logging in → checking your environment, in order. If something's missing (like a runtime), it asks for consent and installs it. You only do this once.

Create an app

Just say what you want to build.

create a Next.js app

The plugin picks a template, creates a GitHub repo, and runs the first deploy — all at once. Templates like Next.js, Vite, and Astro are available.

Anything that actually changes something — like a deploy — asks for confirmation first. You can let it run or stop it.

Deploy and check

After you edit code, deploy and check results by talking too.

deploy this app
open the app
why did it fail?

That last one pulls the failed deploy's logs and points out the cause.

Use the CLI directly

If you'd rather work in the terminal, you can do the same thing with commands.

# 1. Install & log in
curl -fsSL https://cli.axhub.ai/install.sh | bash   # Windows: irm https://cli.axhub.ai/install.ps1 | iex
axhub auth login

# 2. Create an app (template → repo → first deploy, all at once)
axhub apps bootstrap --name hello --template nextjs \
  --github-owner <github-handle> --repo-name hello --execute --watch

# 3. Check
axhub open hello

For splitting the steps manually (create the app first, connect later), or details like cancel/rollback and environment variables, see the Build & deploy guide and the CLI reference.

When a deploy fails

Start with status and logs — with the plugin, ask "why did it fail?"; with the CLI, run axhub deploy status <id> --app <app> and axhub deploy logs <id> --app <app>.
For symptom-by-symptom fixes, see the When a deploy fails guide.