CLI Reference

The @aiorg/cli is how you install and manage aiorg kits.

Installation

The CLI runs via npx — no global install needed:

npx @aiorg/cli <command>

Commands

init

Download and set up a kit in a new folder.

npx @aiorg/cli init <kit-name> <path>

Examples:

# Free kit (no login needed)
npx @aiorg/cli init idea-os ~/my-idea

# Paid kits (requires login first)
npx @aiorg/cli init marketing-os ~/my-marketing
npx @aiorg/cli init saas-dev-team ~/my-saas

Arguments:

Argument	Description
`kit-name`	Name of the kit to install
`path`	Where to create the project

upgrade

Update an existing kit to the latest version.

cd ~/my-project
npx @aiorg/cli upgrade

This will:

Check your current version
Download the latest version
Merge changes (preserves your customizations)

Always commit your changes before upgrading. The CLI preserves your files in config/, .env*, and other user data folders.

login

Authenticate with your license key (required for paid kits).

npx @aiorg/cli login

You'll be prompted to enter your license key. Get your key from your purchase confirmation email.

list

Show all available kits.

npx @aiorg/cli list

Output:

Available Kits:

FREE:
  idea-os            Business idea validation

PAID (requires license):
  marketing-os       Marketing automation + landing pages
  saas-dev-team      Full-stack SaaS template

version

Show CLI version.

npx @aiorg/cli --version

Troubleshooting

"Kit not found"

Make sure you spelled the kit name correctly. Run npx @aiorg/cli list to see available kits.

"License required"

Paid kits need a license. Run npx @aiorg/cli login and enter your key.

"Upgrade failed"

Commit your changes first
Make sure you're in the project root (where .claude/ folder is)
Try again

"Permission denied"

Make sure you have write access to the target folder.

Getting Your License Key

After purchasing, you'll receive your license key via email. You can also find it on the success page right after checkout.

Lost your key? Contact support@aiorg.dev