# Gaunt Sloth

> A configuration-driven AI assistant for the command line. Review code and pull requests, ask
> questions, run agentic coding sessions, script prompts non-interactively, and grade agents and
> MCP servers with a built-in eval harness. MIT licensed. Bring your own model — hosted or local.

Install with `npm install -g gaunt-sloth`. Requires Node.js 24+ and npm 11+. The CLI is
installed under three interchangeable names: `gaunt-sloth`, `gsloth` and `gth`.

Commands: `init`, `ask`, `chat`, `code`, `exec`, `review`, `pr`, `eval`, `batch`, `workflow`,
`api ag-ui`, `models`, `get`, `config`, `history`, `insights`.

Providers: Anthropic, Google (Vertex AI and AI Studio), OpenAI, Groq, DeepSeek, xAI, OpenRouter,
Hugging Face, and local Ollama or LM Studio endpoints, plus any other LangChain.js-compatible
provider via JavaScript config.

## Documentation

- [Documentation home](https://gauntsloth.app/docs/): guides, configuration and command reference
  for the current 2.x line.
- [Commands reference](https://gauntsloth.app/docs/commands/): every command, argument and flag.
- [Configuration](https://gauntsloth.app/docs/configuration/): providers, prompts, tools, MCP
  servers and identity profiles.
- [Config schema](https://gauntsloth.app/schema/v2/gsloth-config.schema.json): the JSON schema for
  `.gsloth.config.json`. There is no directory index at `/schema/` — link the file itself.

## Source

- [GitHub repository](https://github.com/pukeko-robotics/gaunt-sloth)
- [npm package](https://www.npmjs.com/package/gaunt-sloth)

## Optional

- [Frozen v1 documentation](https://gauntsloth.app/docs-v1/): superseded by /docs/ and served
  `noindex`. Only relevant if you are pinned to the 1.x line.