Installation

Testy Claw is distributed as an npm package. Install it globally once and use it in any project on your machine.

Requirements

Requirement	Version	Notes
Node.js	≥ 18.0.0	LTS recommended
npm	≥ 9.0.0	Comes with Node.js
OS	macOS, Linux, Windows	WSL2 recommended on Windows

Global install (recommended)

Install Testy Claw globally so the testy-claw command is available everywhere on your machine.

terminal

npm install -g testy-claw

Verify the installation:

terminal

testy-claw --version
# → testy-claw/1.0.0 darwin-arm64 node-v20.11.0

Project-local install

If you prefer to pin the version per project, install it as a dev dependency and run it via npx.

terminal

npm install --save-dev testy-claw

# Then run with:
npx testy-claw run "your task"

Set your API key

Testy Claw uses a language model to plan and execute tasks. Set your provider API key as an environment variable before running any commands.

terminal

# OpenAI (default)
export OPENAI_API_KEY=sk-...

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-...

# Or add to your shell profile (~/.zshrc, ~/.bashrc)
echo 'export OPENAI_API_KEY=sk-...' >> ~/.zshrc

WarningNever commit API keys to source control. Use environment variables or a .env file (add it to .gitignore).

Verify everything works

terminal

testy-claw run "print hello world to the terminal"

  ◎ Planning...
  ✓ Executed: echo "hello world"
  → hello world
  ✓ Done in 0.8s

TipNext: follow the Quick Start guide to run your first real agent task.