Getting Started

1. Install the GitHub CLI

Download from cli.github.com and authenticate:

gh auth login

2. Install the gh-calab Extension

gh extension install calab-ai/gh-calab
gh calab --version

3. Browse the Marketplace

# List all packages
gh calab apm list packages
 
# List all primitives
gh calab apm list primitives
 
# Search by tag
gh calab apm search --tag agents

4. Install Your First Package

# Install the workspace base package (agents + instructions + skills)
gh calab apm install package calab.package.workspace-base

This installs all included primitives and writes a lockfile (apm.lock.yaml) to your repository.

5. Install a Single Primitive

gh calab apm install primitive calab.agent.build

Cross-references

• Concepts — understand primitives, packages, and lockfiles
• Handbook APM onboarding: see the Calab.ai Handbook for workspace-level setup guidance