ExecuteSpec CLI

Command-line client for ExecuteSpec.

Use it to chat from any folder, submit specs, watch runs, approve plan gates, inspect run status, and run local-hands workflows against a trusted working tree. The CLI is intentionally thin: the agent loop, prompts, model routing, scoring, billing, and durable run history stay server-side.

Install

npm install -g @executespec/cli

Both commands are installed:

executespec
es

Start Chat

Run this from any project folder:

executespec

If you are not signed in, the CLI starts the web-login flow. After login, plain text is treated as chat. Slash commands are optional.

Common Commands

executespec --help
executespec config get host
executespec config set host https://dev.executespec.ai
executespec auth login
executespec run submit "add a /health endpoint with tests" --watch

Default Host

The default backend is:

https://dev.executespec.ai

Override order:

1. --host
2. EXECUTESPEC_HOST
3. stored config
4. built-in default

Safety Model

Remote runs execute through the ExecuteSpec backend and do not mutate your local working tree. Local-hands mode is separate and requires explicit local context, workspace trust, and guardrails before file or shell tools are used.

License

Proprietary. All rights reserved.