Clarity

A free, open-source plugin for Claude

Claude Code just changed 14 files, installed three packages, and restructured your database. You might follow some of it. But do you understand all of it?

You can ask Claude to explain things. But that only works when you know what to ask about.

What about the files you didn't notice it changed? The dependency it added without mentioning? The architectural decision it made while you were reading the last one?

Clarity is a plugin that walks through everything Claude did. Systematically. In language you can actually follow. It catches what you wouldn't think to ask about, because you didn't know it happened.

Why not just ask Claude?

You can. And sometimes that's enough. But when Claude changes 30 files in a session, you'd need to know which ones to ask about. Clarity doesn't wait for you to notice something. It walks through everything and tells you what matters.

What Clarity does

1. You build something with Claude

You use Claude Code as normal. It writes code, makes changes, installs things. You follow along, mostly. Some of it you understand. Some of it moves fast.

2. Clarity explains what happened

Type /clarity:explain for one thing, or /clarity:session for everything. Clarity reads what Claude did and walks you through it in plain language. Every change, every decision, every dependency.

3. You know what to ask next

Every explanation ends with specific prompts you can use in your next session. You don't just understand what happened. You know what to do about it.

What Clarity is not

It doesn't judge code quality.

Clarity doesn't tell you if the code is good or bad. It explains what changed and why, so you can decide what to do next.

It doesn't fix things.

Clarity translates. It doesn't make changes, suggest fixes, or rewrite anything. That's your call.

It's Claude explaining Claude.

This is not an independent audit. Clarity is Claude looking at its own work and explaining it. Useful for understanding. Not the last word on anything.

Who uses Clarity

Non-technical founders

You're building a product with AI but you're not writing the code yourself. Clarity tells you what your AI tool actually did, so you can make informed decisions about your own product.

Solo operators

You're technical enough to use Claude Code but not a full-time developer. Clarity fills the gap between "I asked for this" and "here's what was actually built".

Teams with oversight responsibilities

Someone on the team needs to understand what the AI built, even if they didn't build it themselves. Clarity gives them a plain-language summary they can actually read.

The honest bit

  • Clarity helps you understand what AI built. That understanding is yours to act on.
  • The explanations are best-effort translations, not authoritative assessments.
  • If something in a Clarity explanation concerns you, share it with a developer for a second opinion.
  • Clarity is licensed under Apache 2.0.
  • It is provided as-is, without warranty of any kind.
  • Clarity does not accept liability for decisions made based on its explanations.

How to get Clarity

Clarity works with Claude Code (the command-line tool).

Submitted to the Anthropic plugin marketplace. Download from GitHub in the meantime.

Install from GitHub

  1. Download Clarity from GitHub (click the green "Code" button, then "Download ZIP")
  2. Unzip the folder somewhere on your computer
  3. In Claude Code, run:
claude plugin install /path/to/Clarity

Type /clarity:help to check it's working

Uninstall

To remove Clarity, run:

claude plugin uninstall clarity

How to use Clarity

Once installed, these commands are available inside Claude. Type any of them to get started.

/clarity:explain
Explain one thing. A file, an error, an output, or a concept. No argument explains the last thing Claude said.
/clarity:session
Explain what happened in the current session. Every change, decision, and dependency in plain language.
/clarity:project
Walk through the full project. What it is, how it's built, what the risks are, and what to ask next.
/clarity:config
Set where Clarity saves explanation files.
/clarity:help
Show the full command reference.

Companion plugin: Attest

Clarity explains what AI built. Attest is the other half: a structured review workflow that surfaces questions about any AI-generated output, captures your decisions, and produces an auditable decision log. Different jobs. Same goal: keeping humans in control.

Get Clarity

Submitted to the Anthropic plugin marketplace. Download from GitHub in the meantime.

Download from GitHub →

Stay updated

Get notified when Clarity lands in the Claude plugin directory and when we add new features.

Have a specific question?

Clarity: because "trust me, it's fine" isn't oversight.