CLI Reference

Command Overview

aidk [command] [options]

Command	Description
`aidk init`	Initialize AIDK structure in the current project
`aidk add rule <name>`	Add a new rule
`aidk add skill <name>`	Add a new skill
`aidk add workflow <name>`	Add a new workflow
`aidk update`	Check and update components from the registry
`aidk --version`	Print current version
`aidk --help`	Display help

Initialize AIDK in the current directory.

aidk init

Options:

Examples:

# Initialize for Cursor IDE
aidk init --ide cursor

# Overwrite existing structure
aidk init --force

Add a new rule file to .agent/rules/.

aidk add rule <name>

Example:

aidk add rule security
# Creates: .agent/rules/security.md

Add a new skill to .agent/skills/.

aidk add skill <name>

Example:

aidk add skill fastapi
# Creates: .agent/skills/fastapi/SKILL.md

Add a new workflow to .agent/workflows/.

aidk add workflow <name>

Example:

aidk add workflow deploy
# Creates: .agent/workflows/deploy.md

Check for changes in installed components and discover new components from the registry.

aidk update

This command performs the following actions:

Check for Changes: Compares the current rules, skills, and workflows in your project with the latest versions in the AIDK registry.
Discover New Components: Automatically identifies new components (rules, skills, workflows) available in the registry that you haven't installed yet.
Selective Update: Provides an interactive interface for you to choose whether to update everything or select specific components.

Example:

# Check and update the entire project
aidk update

Error	Cause	Solution
`Command not found: aidk`	Not installed or PATH not set	Run `npm install -g @caeruxlab/aidk`
`ENOENT: .agent already exists`	Directory already exists	Use `--force` flag
`403 Forbidden`	npm registry auth error	Check `.npmrc` and GitLab token