suss

Find bugs with a codebase-aware AI agent.

Suss looks for bugs in your local code changes, i.e. the diff between your local and remote branch. Just run suss in your terminal to get a bug report in under a minute.

For each code change, an AI agent gathers context on how it interacts with the rest of the codebase. Then the agent audits the change and its downstream effects on other code.

Think of suss as a quick and easy sanity check before pushing your code.

Installation

> pipx install suss

Once installed, you must choose an LLM provider. To use OpenAI or Anthropic, just add your API key to your environment:

> export OPENAI_API_KEY="..." # For GPT
> export ANTHROPIC_API_KEY="..." # For Claude

You can also use other models, including local ones. suss wraps LiteLLM, so you can use any model listed here.

Optional: You can boost performance using the Cohere reranker model. Just add your Cohere API key to your environment:

> export COHERE_API_KEY="..."

Usage

Run suss in the root directory of your codebase.

By default, it analyzes every code file that's new or modified compared to your remote branch. These are the same files you see when you run git status.

To run suss on a specific file:

> suss --file="path/to/file.py"