suss 0.3.0

AI-powered bug finder that knows your codebase

suss

Check your code for bugs with a codebase-aware agent.

Just run suss in your terminal to get a bug report in under a minute.

suss analyzes the diff between your local and remote branch. For each code change, an AI agent gathers context on how it interacts with the rest of the codebase. The agent then audits the code change for bugs, including downstream effects on other 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.

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"