CH·02CLI reference

gpu skill

Install the GPU.ai skill for coding agents (Claude Code, Codex)

Synopsis

Teaches coding agents to rent and drive GPU.ai instances through this CLI. The skill is the operating rules plus reference files for deploys, fine-tuning, and troubleshooting. install writes them where each agent discovers them: a ~/.claude/skills/gpu-ai/ directory (SKILL.md plus references/) for Claude Code, and a managed block in ~/.codex/AGENTS.md for Codex. show prints every file install would write.

The skill covers the full rent-run-teardown loop — discovering hardware and prices, provisioning, SSH-ing in, and (importantly) deleting instances when done — with cost-safety rules the agent must follow, like quoting the $/hr price before creating anything. The reference files carry the depth: worked examples and flag detail for gpu deploy and gpu fine-tune, and a symptom → cause → fix guide for timeouts, stuck operations, and auth errors. The cost-safety rules live only in the body, never in a reference file, so a reference file can be omitted without weakening them.

gpu skill commands are purely local (they write agent config files) and work before gpu login.

Examples

# Install for every coding agent found on this machine
gpu skill install

# Install for one agent explicitly
gpu skill install --agent claude
gpu skill install --agent codex

# Review everything that would be installed
gpu skill show
gpu skill show --agent codex

For the full guide — what installs where, what the agent can do, and the built-in spending guardrails — see docs/agent-skill.md.

Synopsis

Examples

SEE ALSO