Repository navigation
Home
This page tells what claudetto does and which plugins it has.
It is for new users, who read it before the install steps.
It also shows where to read next for each task.
claudetto is a Claude Code plugin marketplace for software engineering.
It changes Claude Code through the Mod API, settings, hooks, skills, agents, and output styles.
It does not patch the binary.
Its goal is the highest quality for the lowest token cost.
claudetto 0.1.0 is the restart of the earlier plugin dotclaude 1.0.0, with a new name and no compatibility with it.
claudetto needs Claude Code 2.1.302 or later.
claudetto does the following:
- Gives permission rules and a sandbox in the settings snippet. The rules ask or deny destructive actions, as Guards describes.
- Gives
askrules for recursivermcalls in the settings snippet. - Turns off the built-in compaction and replaces it with a handoff. See Handoff.
- Selects the output style
claudetto:Concisewith the settings snippet. The style leads with the result and keeps replies short. - Changes parts of the built-in system prompt and of the tool descriptions, through the Mod API. See Prompt.
- Gives Claude six agents, each with a model, an effort, and a turn limit:
reviewer,implementer,debugger,investigator,planner, andresearcher. See Agents. - Plans and tracks a change with files, skills, and the
minispecCLI. See MiniSpec. - Shows the folder, the git state, the active change, the model and effort, the context, the cost, and the usage limits. It shows them in a status line. See Status Line.
The core plugin is claudetto.
Each add-on is a separate plugin.
Each add-on works without the core plugin.
| Plugin | What it does | Reference |
|---|---|---|
claudetto |
The core plugin. It gives the output style, the agents, the guards, the status line, the handoff, MiniSpec, the prompt profile, the setup, and the opt-in second opinion (second_opinion). |
Overview, Architecture, Decision API |
claudetto-codegraph |
Gives Claude the code graph of a project from the CodeGraph CLI codegraph. |
Code Graph |
claudetto-browser |
Drives a browser with agent-browser. It answers each WebSearch call with a headless browser search. |
Browser |
claudetto-docs |
Gets current library and API docs with the Context7 CLI ctx7. |
Library Docs |
claudetto-sessions |
Measures the start of a session by source, and the usage of each run. | Sessions |
claudetto-lab |
Gives tools for plugin authors: a sandbox for Claude Code, a request capture, the JSON Schema of settings.json, and an eval compare. |
Lab |
claudetto-you-should-know |
Opt-in. Shows one thing to know before Claude changes something. | You Should Know |
The marketplace and the install steps are in Add-Ons and Install.
The design principles are on Design. These are some of them.
- Only documented extension points.
- No model call for a check that a script can make.
- One owner for each bound.
- Each plugin works alone.
| Page | Read it to |
|---|---|
| Quickstart | See what happens in a first session. |
| Install | Install the marketplace and the plugins. |
| Overview | See what each plugin and each feature of claudetto is. |
| Architecture | See how the core plugin is built, from src/ to plugins/. |
| Guards | Learn what asks, what denies, and what the sandbox does. |
| Settings Snippet | Copy the keys that Claude Code needs. See also Settings Snippet Keys and Settings Schema. |
| Hook Events | See the events that Claude Code sends, and the map to the claudetto events. |
| Undocumented Reads | See the settings and env vars that the binary reads and the docs do not name. |
| Troubleshooting | Fix a symptom. |
| Development and Sandbox | Change claudetto and test a checkout. |
| Attributions | See the projects whose ideas claudetto reimplements. |
| Page | What it holds |
|---|---|
| Design | The design principles of claudetto, and why each is in force. |
| Decisions | The design decisions of claudetto, in groups. |
| Evidence | The measured facts that the decisions use. |
| Evals | What the evals measure, and the Claude Code version that they need. |
| Prompt | The output style, the prompt sections, and the tool texts. |
| Request Build | The system prompt sections, the attachments, and the cache of a request. |
| Release History | Where the notes of each release are. |
The CHANGELOG lists each release.
The section of the version in package.json holds the changes of the release in progress until that version has a tag.
After the tag, the [Unreleased] section holds the new changes.
The evidence pages label each fact with its source.
| Label | Source |
|---|---|
| official | Anthropic documentation or support pages |
| binary | read from the installed Claude Code bundle, never patched |
| capture | a request body that Claude Code sent to a local listener |
| measured | a run or a transcript scan on the maintainer's machine |
| reported | user reports |
| inference | a conclusion from the facts above |
A binary fact names the Claude Code version that it is for.
The extracts of the bundle are in the git-ignored external/ folder, as Claude Code Internals describes.
- Install: install the marketplace and the plugins.
- Quickstart: see what happens in a first session.
- Start
- How claudetto Works
- Add-On Plugins
- How Claude Code Works
- Reference
- Rationale
- Evidence
- Development
- Archive