codegraff

<p align="center">
  <img src="docs/images/readme-rats.png" alt="CodeGraff workshop rats in coral coats" width="280" height="280">
</p>

<h1 align="center">CodeGraff</h1>

<p align="center">An AI coding agent for your terminal. One small binary, no dependencies.</p>

<p align="center">Want a desktop app? <a href="https://github.com/justrach/harness"><strong>Harness</strong></a> runs graff with chat, review, files, and terminals in one window.</p>

<p align="center">
  <img alt="macOS · Linux · Windows" src="https://img.shields.io/badge/macOS%20·%20Linux%20·%20Windows-555">
  <img alt="One binary, 3.7 MB" src="https://img.shields.io/badge/one%20binary-3.7%20MB-44cc11">
  <img alt="Zero dependencies" src="https://img.shields.io/badge/dependencies-0-44cc11">
  <img alt="Built in Zig 0.17 dev" src="https://img.shields.io/badge/built%20in-Zig%200.17%20dev-f7a41d?logo=zig&logoColor=white">
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/84216?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-84216" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/84216" alt="justrach/codegraff | Trendshift" width="250" height="55"></a>
</p>

<p align="center">
  <a href="#install">Install</a> ·
  <a href="#what-it-does">What it does</a> ·
  <a href="#mcp-servers">MCP</a> ·
  <a href="#desktop-app">Desktop app</a> ·
  <a href="#use-it-from-code">SDKs</a> ·
  <a href="#evaluation-results">Evaluations</a> ·
  <a href="#development">Development</a>
</p>

## Install

On macOS or Linux:

```sh
curl -fsSL https://github.com/justrach/codegraff/releases/latest/download/install.sh | sh
```

On Windows, in PowerShell (no WSL needed):

```powershell
irm https://github.com/justrach/codegraff/releases/latest/download/install.ps1 | iex
```

It verifies the download against the release's `SHA256SUMS`, installs
`graff.exe` under `%LOCALAPPDATA%\Programs\graff\bin` and adds that to your user
`PATH`. The desktop app, [Harness](https://github.com/justrach/harness), installs
`graff` for you.

```sh
graff login                      # sign in
graff                            # start an interactive session
graff -p "Explain this project"  # ask one question, answer on stdout
```

`graff update` installs the latest stable release, and `graff update --beta`
the newest beta. Both check the download against the release's `SHA256SUMS`.

<details>
<summary>Other sign-ins, installing from a checkout, and editors</summary>

```sh
graff login chatgpt             # ChatGPT sign-in (same as: graff login codex)
graff login anthropic           # Claude subscription browser sign-in (alias: ant)
graff login kimi
graff login zai
graff login xai
graff login console             # Anthropic Console account (API credits), via Anthropic's `ant` CLI
graff key set deepseek sk-...   # any provider by API key
graff --model grok-4.6
```

Anthropic browser login uses native OAuth, not the Claude CLI or its credential
files.