Testy-Claw wakeup

Boot the Testy Claw agent. Running wakeup initialises the runtime, loads your config and tools, verifies your API key, and prints a ready prompt — all before you send a single task.

Usage

terminal

testy-claw wakeup [options]

What happens on Testy-Claw wakeup

When you run Testy-Claw wakeup, the agent goes through a boot sequence in order:

Reads claw.config.ts (or falls back to defaults if none exists)
Resolves and validates every enabled tool
Pings the configured model provider to verify the API key is valid
Prints the loaded config summary — model, tools, limits
Prints ✦ Testy Claw is awake and a ready prompt

Example output

terminal

$ testy-claw wakeup

  ✦ Testy Claw is awake
  ◎ Loading tools     fs · shell · http · git
  ◎ Model             gpt-4o  (openai)
  ◎ Config            claw.config.ts
  ◎ Max steps         20
  ◎ Timeout           30s
  ✓ API key valid
  ✓ Ready — type your task below

$ _

TipRun wakeup before your first task of the day to confirm your environment is healthy — especially useful in CI to catch missing API keys early.

Interactive mode

After wakeup, you can pass tasks directly without re-typing the command prefix. The agent stays loaded in memory between tasks, making repeated runs faster.

terminal

$ testy-claw wakeup

  ✦ Testy Claw is awake
  ✓ Ready — type your task below

> scaffold a REST API in ./src
  ◎ Planning 5 steps...
  ✓ Done in 2.1s

> add JSDoc to all functions in src/
  ◎ Planning 3 steps...
  ✓ Done in 1.4s

> exit

Options

Flag	Default	Description
--no-ping	false	Skip the API key ping check on startup
--verbose	false	Print detailed boot diagnostics
--model <id>	config	Override the model for this session
--once	false	Exit after the first task (non-interactive)

Common Testy-Claw wakeup errors

Error	Cause	Fix
API key invalid	OPENAI_API_KEY not set or wrong	Set the correct key in your shell or .env file
Tool not found: shell	Tool listed in config but not installed	Check your tools array in claw.config.ts
Config parse error	Syntax error in claw.config.ts	Run testy-claw config validate to see the exact error
Model not available	Model ID doesn't exist for the provider	Check supported models in the Models & Providers doc

Notewakeup exits with code 0 when the agent is ready, and 1 if any check fails. This makes it safe to use as a health-check step in CI before running tasks.