Sanity

Sanity is a software design tool for developers and coding agents.

Use Cases

• Build maintainable software
• Understand codebases
• Audit AI-generated code
• Stabilize and reclaim apps built with AI

Quick Start

Step 1: Install on macOS/Linux using Homebrew:

brew install sanity

Step 2: Inside your project:

sanity setup  # Add usage instructions to AGENTS.md for your coding agent

For other installation methods (pre-built binaries, build from source, Go install), see the Installation Guide.

The Problem

Every time a coding agent makes changes to your codebase, you have the following questions:

• Which files should I review first and in what order?
• Where should I spend most of my review effort?
• What is the blast radius of this change?
• Which parts of the change are too risky?
• How does this solution fit into the existing system?
• Are there adequate tests for these changes?

These concerns worsen when there are:

• Too many files to review
• You have an outdated mental model of your codebase

How Sanity Helps

Sanity uses a file-based dependency graph to visualize the impact of AI-generated changes, showing you:

• The files changed and the relationships between them
• The order to review files (simple answer: review from right-to-left)
• Color-coded files by extensions to quickly categorize and group them for review
• Identify test files at a glance
• Help you build an accurate mental model of the system as you evolve it

Visuals

Fig. 1: Relationships between impacted files are shown and tests are highlighted in green.

Fig. 2: New files are marked with a 🪴 emoji.

Supported Languages

• C
• C++
• C#
• Dart
• Go
• JavaScript
• Java
• Kotlin
• Python
• Ruby
• Rust
• Swift
• TypeScript