Guides

A clear flight plan for coding agents

Agents work best when discovery is small, commands are exact, and every mutation has an observable result. Rocketicons provides a versioned static catalog and a CLI that writes selected components into the project.

Find and add one icon

Inspect /ai/v1/catalog.json or use the website to select a collection.
Follow the collection's indexUrl and identify an exact icon ID.
Reuse an existing file under src/ri/icons when it already fits.
Otherwise run one command: npx rocketicons add @collection/icon.
Import the generated component and verify its file exists.

Add a small set

The current CLI accepts one icon per command. Keep the change auditable:

terminal

Do not assume batch arguments, JSON output, dry-run flags, configurable paths, or MCP tools yet. They are planned for later milestones.

Style states explicitly

Verify the mutation

terminal

Report each changed file. Run the project's own type check and relevant web or native build before declaring success.

Prompt you can reuse

Use Rocketicons for icons in this project. Reuse a suitable component under src/ri/icons when possible. Otherwise identify an exact @collection/icon ID, run one Rocketicons add command for it, import the generated component through @/ri, and report every file created or changed. Do not install or import a full icon collection.

For a compact machine-readable reference, point the agent to /llms.txt.

Catalog version: 0.3.1 · Content updated: 2026-08-12