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.
| Skill | The agent learns |
|---|---|
archipelago-cli-create | create 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-bricks | brick list, info, download, update, what Free, Pro and Enterprise include, and auth login, status and activate. |
archipelago-cli-upgrade | upgrade with --dry-run, the 3-way merge, adopt, and when ARCHIPELAGO_FORCE=1 is safe. |
archipelago-cli-troubleshooting | Exit 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@ getChoose 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
--outputwith a dedicated directory. Never generate into an existing workspace root. - Never overwrite your edits: use
upgrade, and ask you beforeARCHIPELAGO_FORCE=1. - Never print or store tokens. You finish
auth loginyourself by typing the code shown in the terminal.
See also the CLI reference and Upgrading generated packages.