@zoebuildsai/orbit

The official CLI for Orbit — the skill & persona registry for AI agents.

Installation

npm install -g @zoebuildsai/orbit

Or run directly with npx:

npx @zoebuildsai/orbit <command>

First Run

If no account is linked, Orbit will show:

No account linked. Run 'orbit login' to connect, or continue as anonymous (free skills only).

Anonymous mode lets you search and install free-tier skills without an account.

Skill Commands

orbit login

Authenticate with your Orbit account.

# Interactive browser flow (device auth)
orbit login

# Headless / CI mode — provide API key directly
orbit login --token <YOUR_API_KEY>

orbit search <query>

Search the Orbit skill registry.

orbit search "web scraper"
orbit search "data" --category utilities
orbit search "agent" --sort newest
orbit search "code" --limit 5 --json

orbit install <skill-name>

Download and install a skill.

orbit install web-scraper
orbit install my-skill --dir ./my-skills
orbit install pro-skill --dry-run

Skills install to ~/.openclaw/skills/<slug>/SKILL.md.

orbit uninstall <slug>

Remove an installed skill.

orbit uninstall github-ops
orbit uninstall github-ops --force

orbit update [skill-name]

Update installed skills.

orbit update          # check all
orbit update my-skill # specific skill

orbit list

List all installed skills.

orbit info <slug>

Show detailed info about a skill.

orbit rate <slug> <1-5>

Rate a skill.

orbit rate github-ops 5 --review "Works perfectly"

orbit validate [path]

Validate a skill directory before publishing.

orbit whoami

Show the currently authenticated user.

Persona Commands

Personas are AI agent personalities with bundled skills, system prompts, and behavior configuration.

orbit persona search <query>

Search for personas.

orbit persona search "developer"
orbit persona search "writer" --json

orbit persona install <slug>

Download and install a persona (+ bundled skills).

orbit persona install syntax
orbit persona install syntax --dry-run

Personas install to ~/.openclaw/personas/<slug>/ and bundled skills to ~/.openclaw/skills/<slug>/.

orbit persona info <slug>

Show detailed info about a persona.

orbit persona files <slug>

Preview the files in a persona before installing.

orbit persona files syntax
orbit persona files syntax --content  # show full file contents

orbit persona list

List locally installed personas.

orbit persona uninstall <slug>

Remove an installed persona.

orbit persona rate <slug> <1-5>

Rate a persona.

orbit persona rate syntax 5 --review "Great personality for code review"

Configuration

Config file: ~/.orbit/config.json

Environment variables:

• ORBIT_API_URL — override the API base URL
• OPENCLAW_SKILLS_DIR — override skills install directory
• OPENCLAW_PERSONAS_DIR — override personas install directory

Development

npm install
npm run build
npm run typecheck
npm test

License

MIT