Command Reference
AI Agent Setup
Configure sped-cli for your AI coding agent
AI Agent Setup
sped-cli supports 11 AI coding agents with ready-to-use skill files that teach each agent to use short aliases instead of long shell commands.
One-command setup
npm i -g @electrooo69/sped-cli@latest --force; sped setup --all
What gets created
Skill files (per agent)
| Agent | Flag | Output File |
|---|---|---|
| Claude Code | --claude | CLAUDE.md |
| OpenAI Codex | --codex | AGENTS.md |
| Gemini CLI | --gemini | GEMINI.md |
| GitHub Copilot | --copilot | .github/copilot-instructions.md |
| Cursor | --cursor | .cursor/rules/sped-cli.mdc |
| Windsurf | --windsurf | .windsurf/rules/sped-cli.md |
| Antigravity | --antigravity | GEMINI.md |
| Cline | --cline | .cline/instructions.md |
| Amp | --amp | .amp/instructions.md |
| Continue | --continue | .continue/instructions.md |
| Aider | --aider | .aider.instructions.md |
.sped-cli/ reference folder
Every sped setup also creates a .sped-cli/ folder containing:
aliases.json— machine-readable alias→command map (agents cangrepthis)DOCS.md— full alias→command reference table with workflow examplesSKILL_REFERENCE.md— the complete instruction file
This gives agents a persistent reference they can check anytime.
Universal Prompt
After setup, paste this into any AI agent to ensure it uses sped-cli:
Setup once per project: install with `npm i -g @electrooo69/sped-cli@latest --force`, then run `sped setup --all` in the project root if `.sped-cli/` is missing.
Never delete `.sped-cli/`.
Only follow the instruction file for your current agent. Do not delete or modify other agents' instruction files unless explicitly asked.
Read the entire `.sped-cli/DOCS.md` and `.sped-cli/aliases.json` files before using shell commands.
Use sped-cli aliases whenever available (`gs`, `ni`, `nxa`, etc.). If an alias is unavailable, expand it manually and include a short comment noting which alias you expanded. Never silently use long-form commands.
Examples
# Install for Claude Code and Cursor only
sped setup --claude --cursor
# Overwrite existing files
sped setup --all --force
# Auto-detect (installs for agents found in your project)
sped setup
What the skill files contain
Each skill file includes:
- Mandatory rules at the top — agents are told to use aliases for ALL commands
- Most-used aliases table — compact reference for the top 324 commands
- Framework workflow examples — Next.js, Vite, Supabase, Prisma patterns
- Fallback instructions — what to do if an alias binary isn't available
- Full 324-alias reference organized by category
This ensures your AI agent generates efficient, token-optimized shell commands automatically.