Skip to content

CLI Reference

Agent skills ​

archipelago_cli ships skills for AI coding agents. A skill is a short Markdown guide that an agent loads when your request matches it. These four teach an agent to use the CLI with real commands and flags, and to avoid mistakes that cost you work.

SkillThe agent learns
archipelago-cli-createcreate and generate with --output, a JSON config and --on-conflict for runs without a terminal, then melos bootstrap and analyze to check the result.
archipelago-cli-bricksbrick list, info, download, update, what Free, Pro and Enterprise include, and auth login, status and activate.
archipelago-cli-upgradeupgrade with --dry-run, the 3-way merge, adopt, and when ARCHIPELAGO_FORCE=1 is safe.
archipelago-cli-troubleshootingExit codes, expired logins, brick not found, the CLI version gate and hook failures.

Install ​

Add archipelago_cli to your project (a dev dependency is enough), then run:

bash
dart run skills@ get

Choose the skills in the prompt. The tool installs them into your project's .agents/skills/ directory. Rerun the command after you update archipelago_cli to get the new text.

Safety rules the skills teach ​

  • Always pass --output with a dedicated directory. Never generate into an existing workspace root.
  • Never overwrite your edits: use upgrade, and ask you before ARCHIPELAGO_FORCE=1.
  • Never print or store tokens. You finish auth login yourself by typing the code shown in the terminal.

See also the CLI reference and Upgrading generated packages.