What is windvane?
windvane is a Claude Code mod by 20alexl that babysits a long Claude Code session so you don't have to: the context fill is watched, the recorder drafts the checkpoint, compaction happens at the right point with the state banked and. It is listed under Security and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | 20alexl |
| Repository | 20alexl/windvane |
| Popularity | no public popularity data yet |
| Category | Security |
| Security | High risk (32/100) |
| Rank | #2,453 of 5,272 Claude Code mods; #288 in Security |
| License | MIT |
| Last commit | 2026-10-12 |
| Hooks | 19 events |
| Sees | Agent calls, classic hooks, compaction, every prompt, every tool call, mcp__windvane__checkpoint calls, mcp__windvane__compact_now calls, mcp__windvane__deps calls, mcp__windvane__log calls, mcp__windvane__memory calls, mcp__windvane__mine calls |
| Draws on | AbovePrompt, Pane |
Is windvane safe to install?
windvane scores 32/100 on the MCPMods security check: High risk. Things to review: sends data over the network; starts processes outside the sandbox; writes files or config; reads environment variables; watches every prompt or event. It passed 1 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| Sends data over the network | Review |
| Starts processes outside the sandbox | Review |
| Writes files or config | Review |
| Reads environment variables | Review |
| Watches every prompt or event | Review |
| Drives Claude (model calls, prompts) | Note |
| Validator reported problems | Note |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.after | |
$.clock.every | |
$.clock.now | |
$.command.register | |
$.config.list | |
$.config.set | changes config |
$.env.get | reads env vars |
$.fs.exists | reads files |
$.fs.read | reads files |
$.fs.write | writes files |
$.http.fetch | network requests |
$.process.run | runs processes |
$.prompt.submit | drives Claude |
$.session.compact | drives Claude |
$.session.cwd | |
$.session.id | |
$.session.model | |
$.session.root | |
$.session.usage | |
$.settings.read | reads settings |
$.state.get | |
$.state.set | |
$.store.get | keeps its own state |
$.store.keys | keeps its own state |
$.store.set | keeps its own state |
$.tool.register | drives Claude |
$.ui.ask | draws interface |
$.ui.log | draws interface |
$.ui.open | draws interface |
$.ui.resolve | draws interface |
$.ui.selection | draws interface |
$.ui.status | draws interface |
$.ui.toast | draws interface |
How do I install windvane?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/20alexl/windvane claude plugin validate ./windvane/.
- Install it. Run this in your terminal, then /reload-plugins in an open session.
git clone https://github.com/20alexl/windvane && claude --plugin-dir ./windvane/.
Or ask Claude to set it up
Paste this into Claude Code and it installs windvane for you:
Install the "windvane" Claude Code mod from https://github.com/20alexl/windvane. Run claude plugin validate on it first and show me what it can access before you enable it.
More from 20alexl/windvane
This repository has 2 Claude Code mods on MCPMods.
- windvane-keeper: Brings windvane back when Claude Code unloads it mid-session, so its tools return without /reload-plugins. (Review before installing)