Thurgood

Thurgood is an AI coding agent powered by Case.dev. It runs as both a VSCode extension and a headless CLI, capable of creating and editing files, running commands, using the browser, and more with your permission every step of the way.

Quick Start

1. Get your Case.dev API Key

Sign up at case.dev and get your API key.

2. Install Thurgood

VSCode Extension:

# Install from VS Marketplace (coming soon)
# Or build from source (see Development section below)

CLI:

# Install the CLI
npm install -g thurgood

# Login with your Case.dev API key
thurgood login

3. Start using Thurgood

# Run Thurgood in your project directory
thurgood

Or open VSCode and click the Thurgood icon in the sidebar.

Features

• Create and Edit Files: Thurgood can create and edit files directly in your editor, showing you a diff view of the changes.
• Run Terminal Commands: Execute commands directly in your terminal with full output monitoring.
• Use the Browser: Launch a headless browser, click elements, type text, and capture screenshots.
• MCP Tools: Extend Thurgood's capabilities with Model Context Protocol tools.
• Checkpoints: Snapshot your workspace at each step and restore to any point.

Configuration

Set your API key via environment variable:

export CASE_API_KEY=your-api-key-here

Or create a .env file:

cp .env.example .env
# Edit .env and add your CASE_API_KEY

Available Models

Thurgood uses Case.dev's LLM Gateway, which provides access to:

• Claude Sonnet 4 (default)
• Claude Opus 4
• GPT-4o
• And more via Case.dev

Development

Prerequisites

• Node.js 20+
• npm or pnpm
• Go 1.21+ (for CLI)

Building from Source

# Install dependencies
npm install

# Build the VSCode extension
npm run compile

# Build the CLI
npm run compile-cli

Running the Extension in Development

1. Open this repository in VSCode
2. Press F5 to launch the Extension Development Host
3. The extension will be available in the new VSCode window

Architecture

thurgood/
├── src/                    # TypeScript source (VSCode extension + core)
│   ├── core/              # Core AI logic, tools, prompts
│   ├── standalone/        # Headless/CLI mode support
│   └── extension.ts       # VSCode extension entry point
├── cli/                   # Go-based CLI
├── webview-ui/            # React webview for VSCode
└── proto/                 # Protocol buffer definitions

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Apache 2.0 © 2025 Case Technologies, Inc.

Built with ❤️ by Case.dev