Getting Started
Installation
How to install sped-cli globally
Installation
Requirements
- Node.js 18 or higher
- npm, yarn, pnpm, or bun
Install globally
npm i -g @electrooo69/sped-cli@latest --force
After installation, all 324 aliases are available as standalone commands in your terminal.
Set up AI agent skills
sped setup --all
This creates skill files for all AI agents AND a .sped-cli/ reference folder containing:
aliases.json— machine-readable alias→command mapDOCS.md— full command reference tableSKILL_REFERENCE.md— instruction file for agents
Install for specific agents only
sped setup --claude # Claude Code only
sped setup --codex # OpenAI Codex only
sped setup --gemini # Gemini CLI only
sped setup --cursor # Cursor only
sped setup --copilot # GitHub Copilot only
sped setup --windsurf # Windsurf only
sped setup --antigravity # Antigravity only
sped setup --cline # Cline only
sped setup --amp # Amp only
sped setup --continue # Continue only
sped setup --aider # Aider only
One-command install + setup
npm i -g @electrooo69/sped-cli@latest --force; sped setup --all
Universal Prompt
After installing, paste this prompt into any AI agent (Codex, Claude, Cursor, Copilot, Gemini, etc.):
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.
Windows PowerShell
On Windows, the installer automatically patches your PowerShell profile to resolve conflicts with built-in aliases like h, cp, mv, gc, gl. After install, restart PowerShell or run:
. $PROFILE
Verify installation
sped --version # prints version
gs # runs git status
h README.md # shows first 50 lines
nxa --explain # shows what nxa does