Introduction

Testy Claw is a CLI agent that executes tasks in plain English. Describe what you want done, and the agent plans, runs, and reports back — step by step, right in your terminal.

What is Testy Claw?

Testy Claw is a globally-installed CLI tool that wraps a language model with a set of built-in tools (filesystem, shell, HTTP, Git) and a typed configuration system. You give it a task in natural language; it figures out the steps, executes them, and shows you exactly what it did.

Unlike GUI-based AI tools, Testy Claw lives entirely in your terminal. It integrates with your existing scripts, CI pipelines, and editor workflows without requiring any new infrastructure.

Key features

• Plain-English task execution — describe the task, the agent handles the rest
• Built-in tools for filesystem, shell commands, HTTP requests, and Git
• TypeScript config file with full type safety and IDE autocomplete
• Step-by-step execution log — inspect every action the agent takes
• Replay any past run to debug or audit what happened
• CI/CD ready — works in GitHub Actions, GitLab CI, and Buildkite
• Custom tool support — extend the agent with your own TypeScript functions

Quick example

$ npm install -g testy-claw
$ testy-claw init
$ testy-claw run "create a TypeScript Express server with a /health endpoint"

How it differs from other tools

Most AI coding tools are IDE plugins or web apps. Testy Claw is a CLI-first agent — it runs where your code lives, integrates with your shell, and produces output you can pipe, script, and automate. There is no account required to run it locally.

Next steps

• Installation — get Testy Claw on your machine
• Quick Start — run your first agent task
• Core Concepts — understand how the agent works
• CLI Reference — every command and flag documented