Skip to main content
The Machines agent skill package installs a local MCP configuration for Codex and Claude. Use this when you need terminal-based setup or want to configure multiple AI hosts at once.
For Claude, the Machines plugin is simpler. For hosted connections without local installs, use MCP Setup.

​
Prerequisites

  • Node.js 18+
  • Codex and/or Claude installed locally
  • A Machines account

​
Setup

1

Install for your AI host

npx @machines-cash/agent-skill install --host both
Or install for one host only:
npx @machines-cash/agent-skill install --host codex
npx @machines-cash/agent-skill install --host claude
2

Log in

npx @machines-cash/agent-skill auth login
Approve access in your browser.
3

Confirm connection

Open Codex or Claude and verify that Machines is connected.

​
Commands reference

npx @machines-cash/agent-skill install --host both           # install for both hosts
npx @machines-cash/agent-skill install --host codex          # Codex only
npx @machines-cash/agent-skill install --host claude         # Claude only
npx @machines-cash/agent-skill auth login                    # browser login
npx @machines-cash/agent-skill auth login --manual-key       # manual login fallback
npx @machines-cash/agent-skill doctor                        # health check

​
Example prompts

Once installed, try:
  • show my balance
  • list my cards
  • search apple airpods pro on amazon
  • buy these apple airpods pro on amazon using my default card
  • check the status of my latest purchase

​
Install location

~/.codex/skills/machines-agent-skills
~/.claude/skills/machines-agent-skills

​
Troubleshooting

ProblemFix
Login window didn’t openUse --manual-key flag for manual login
Not connected after installRun doctor to diagnose the issue
Still failingRemove the Machines connection and run install + login again

​
Next steps