RSS
Tools

thimble: a Claude Code plugin for understanding what agents did

thimble is an open-source, Apache-2.0 Claude Code plugin from safety-research that helps you check an agent's work: single keys visualise or simplify the last answer, and cite checks selected words against your files. Install steps, requirements and caveats.

magnifying glass on white table
Photo by Markus Winkler on Unsplash

Updated November 20, 2026: Expanded with install options, requirements, how cards are sandboxed, updates and the project's caveats.

thimble is a Claude Code plugin whose README says it makes it easy to understand what agents did. It gives Claude tools to cite, visualise and label your data, and gives you an interface for checking Claude's work faster. The project lives on GitHub under the safety-research organisation and is licensed Apache 2.0. The README directs feedback and security reports to @mjoerke, whose GitHub profile names him as Matthew Jörke, an AI Safety Fellow at Anthropic. The README is clear that it is a research prototype and not an official Anthropic product.

What it does

In a Claude Code session, you press a single key at an empty prompt, or click it:

  • v, visualise: turns the last answer into an interactive card.
  • s, simplify: gives a shorter, plainer version of the last answer.
  • c, cite: a second Claude checks the words you selected against your files.
  • e, explain: a short explainer of the selected words. thimble also adds explainers and heads-ups to each answer on its own.
  • a, ask: opens a side thread about the selected words or part of a card, and t lists those threads.

There is also a browser workbench, thimble-browser, which you run in a folder of files; per the project notes, it does the same in a web page on your machine. It can reach Claude three ways, chosen at install with --sign-in claude-code, --sign-in api-key or --sign-in wif --wif-file PATH, and changed later with thimble-browser --setup. The Claude Code sign-in runs Claude Code in the background on your Claude plan; the API key option uses ANTHROPIC_API_KEY if set, or a key pasted into the workbench's Settings. Either way, its work counts against your own plan or key.

How to install it

The recommended route is to ask Claude Code to do it. The repository includes instructions for the installing agent, which asks whether you want the plugin alone or the plugin plus the workbench:

claude "install thimble from https://github.com/safety-research/thimble"

To do it yourself, run the install script. It is worth reading the script before you pipe it to bash. Options go after bash -s --, for example --no-browser for the plugin alone. With the workbench, the install takes a few minutes, and running it again is safe: it keeps your install and fixes and restores any missing part.

curl -fsSL https://raw.githubusercontent.com/safety-research/thimble/main/scripts/install.sh | bash

# plugin only, no browser workbench
curl -fsSL https://raw.githubusercontent.com/safety-research/thimble/main/scripts/install.sh | bash -s -- --no-browser

When the install finishes, follow its last line, which tells you what to type, such as /reload-plugins, to enable thimble. A thimble line then appears above the prompt, where you can switch features on or off; if it does not, trust the folder and turn thimble on in /plugin. thimble tour in a shell, or /thimble:tour in Claude Code, gives a two-minute walkthrough. thimble update upgrades it, after which you type /reload-plugins and start thimble-browser --continue again. thimble doctor checks each part and gives the fix for each problem it finds. INSTALL.md also lists uninstall commands; the last one deletes your fixes, labels and workbench workspaces.

Requirements

  • macOS or Linux, with git and curl. On Windows, WSL 2 only, with your tools and data inside the Linux distribution, not under /mnt.
  • Claude Code 2.1.307 or later; the tour needs 2.1.314 or later.
  • Node.js 22.18 or later and Python 3.10 or later.
  • On Linux, bubblewrap, socat and ripgrep for the sandbox that cards run in.
  • For the workbench, uv 0.8 or later, npm and about 2 GB of disk.

How it keeps cards contained

In Claude Code, Claude draws cards of your data, and thimble keeps that card code contained. The project notes say card views run only in a card runner inside Anthropic's sandbox runtime. It has no network access, can read only its own code and the card copies, and writes only to its own folder. Each card gets its own context, so cards stay apart. If the sandbox can't start, cards simply don't run. In the workbench, the server binds to 127.0.0.1 only and card code runs only in its kernels' sandbox. None of this is a security guarantee; see the caveats below.

Fixing it to suit you

thimble has an unusual way of taking feedback. Type /thimble-fix followed by what should work differently, and Claude changes your own copy and tests it. thimble fixes lists your changes, thimble file pr N turns one into a pull request, and updates keep your fixes. A fix that doesn't fit a new release is set aside until you run thimble reapply, and thimble fix off N switches off a fix that misbehaves. The project has moved quickly: releases v1.1.0, v1.2.0 and v1.3.0 came out on November 10, 12 and 14.

Caveats

As a research prototype, the README warns, it may have security vulnerabilities, and those should be reported privately to the author. If Claude Code's own sandbox is on, it may refuse the install's writes outside your working folder. The install guide suggests letting Claude run it outside the sandbox or running it in your own terminal; either way you are giving up that protection for the install, so check the script first. Managed settings that disable all hooks turn thimble off.

Our take

Most agent tooling is about producing more output faster. In our view thimble is one of the few aimed at the other side: reading, checking and trusting what came back. The cite key, where a second Claude checks the words you selected against your files, is the feature we would try first, because it turns vague doubt about an answer into a specific check. It is early software from a research group, so try it on a project where a broken plugin costs you little.

Built by Matthew Jörke

Source: safety-research/thimble (GitHub), Installing thimble (INSTALL.md), thimble notes for Claude Code sessions (CLAUDE.md), thimble releases (GitHub), Matthew Jörke (GitHub profile)

This story first appeared in the claudefox daily briefing for November 11, 2026.