Clarity is a software design tool for developers and coding agents.
Renamed from Sanity: If you previously used
sanity, this is the same project under a new name.
Step 1: Install with npm (cross-platform):
npm install -g @legacycodehq/clarityOr install on macOS/Linux using Homebrew:
brew install clarityStep 2: Inside your project:
clarity setup # Add usage instructions to AGENTS.md for your coding agentMore install options: Installation Guide.
C • C++ • C# • Dart • Go • JavaScript • Java • Kotlin • Python • Ruby • Rust • Swift • TypeScript
- Build maintainable software
- Understand codebases
- Audit AI-generated code
- Stabilize and reclaim apps built with AI
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
Clarity 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 (short answer: review from right-to-left)
- Color-coded files by extension to help you quickly categorize and group them for review
- Test files at a glance
- An accurate mental model of the system as you evolve it
Clarity works with Desktop and IDE coding agents. If you are using a CLI coding agent, the agent can open diagrams in your browser for review.
Clarity shows impacted files and highlights tests in green.
This project is licensed under the GNU Affero General Public License v3.0.