Repository navigation
v2.25.20 — Claude Code, natively
v2.25.20 — Claude Code, natively
The Claude Code host lands, with an install route that needs no Tersio CLI: /plugin marketplace add reads the repo's own .claude-plugin/marketplace.json, and /plugin install tersio@tersio puts the plugin in place. The Tersio CLI route stays, and it is the one that also wires RTK and routes Headroom.
Every change in this release is below, as CHANGELOG.md records it.
Added
- INSTALL.md and README.md now name Claude Code's own install route:
/plugin marketplace addthen/plugin install. The Tersio CLI route follows it as the one that adds RTK and Headroom. - The dashboard's Latest requests, Requests, and Traces tables carry an Agent column: each harness's brand mark and name, sortable and searchable like the other cells.
- Mode switches now save the next session's defaults.
/combo,/caveman,/rtk,/ponytail,/pstack,/headroom, and the stop phrases write the current state to the host section and the shared defaults, so a new session starts where the last one ended. - Claude Code now ships Tersio's MCP server in the plugin bundle, so Headroom recovery and stats tools are reachable from Claude. The host check reads the bundled
.mcp.jsoninstead of assuming the plugin carries one. - The Claude plugin carries pstack's playbooks, skills, principles, and references, and prints the absolute skill directory in the injected rule.
- Claude slash commands gain
/tersio:updateand/tersio:help. - Claude mode stop phrases (
normal mode,stop caveman,caveman off,stop ponytail,ponytail off,pstack off) turn the matching modes off and tell the model that earlier rules no longer apply. - Claude transcript traces now render turns, one model span per request, and tool spans with their results.
Fixed
test/cli/claude-hook.test.tskeys its fake filesystem on one separator, so the Windows runner reads the same paths the hook builds. A Claude mod may not importnode:path, and the fake map kept backslashes.- The menu layout tests pin the update feed. A publish that lands before
npm viewcatches up madedist/tersio.jsprint an update prompt instead of the menu, and seven captures failed on a clean tree. tersio uninstall --host claudeunwraps Headroom's Claude route instead of restoring the OMP gateway and leaving Claude pointed at a stopped proxy.- Claude's RTK toggle now adds or removes the
rtk hook claudeentry in~/.claude/settings.json; the stored preference was previously a label only. - The Claude plugin reads
TERSIO_HOMEandCLAUDE_CONFIG_DIRinstead of assuming~/.tersioand~/.claude. - The host menu no longer lists a disabled “Claude Code — Coming soon” entry beside the real host.
- Headroom routes Anthropic-compatible providers at the proxy root and OpenAI providers under
/v1. Thanks to @FrancoStino (#102). - The bun hand-off probe allows 10s instead of 2s. Under load the probe timed out, the CLI read that as a broken bun, stayed on node, and the runtime test failed with no stated cause.
- The error icons render again. lucide 1.70 renamed
circle-alerttocircle-exclamation-pointandtriangle-alerttotriangle-exclamation-pointand dropped both old keys, which eleven files still named; a missing name falls back to a question-mark glyph, so the build stayed green. happy-dommoves to 21.0.4 for CVE-2026-33943, a high-severity advisory where an unsanitized import alias reached host code. A devDependency, so the shipped bundle is unchanged.
Changed
- The bare
tersiolaunch shows a spinner while its six-hour update cache refreshes from npm and GitHub, and prompts a yes/no CLI update when one is pending. The update row then tucks the installed agents under anAI agentschoice like Uninstall. The submenu updates all agents or one, and marks outdated hosts with their version. The update plan labelsRTK binaryandHeadroom binary, omitslatest unknown, and drops the duplicate closing Tersio line. - Doctor and the Settings diagnosis list each agent's own version instead of the Tersio package version. A host whose agent binary is absent dims and stops hovering; the install badge carries the state, so the redundant “not installed” and leftover-file lines are gone.
- Doctor no longer reports a per-host Headroom route or the shared proxy endpoint. The Headroom binary row stays.
- The Headroom proxy no longer loads its Kompress ONNX model at startup. Footprint falls from about 600MB to 274MB and threads from 23 to 9, measured on the same machine. The cheaper engines still run every turn: Code-Aware AST compression, the compression cache, and CCR, which between them carried the work; one of 131 learned routing patterns had used the model. A deployment that passes
--enable-kompresskeeps it. - The dashboard ships the 97 Lucide icons it names instead of all 2,029, cutting the bundle every user downloads from 2,616 kB to 1,964 kB, and from 872 kB to 705 kB gzipped.
- Carbon moves from Usage to the Insights group in the dashboard rail, above Tools and Projects, because it reads as an impact figure rather than a usage one. The section id and the
fhotkey are unchanged.
Removed
date-fnsandsimple-iconsleave the dashboard workspace. Neither had a single import; together they cost 52MB of installed tree and nothing in the bundle.
Install: tersio install --host claude or, inside Claude Code, /plugin marketplace add KurutoDenzeru/tersio then /plugin install tersio@tersio.
npm: @krtclcdy/tersio@2.25.20
Full history: CHANGELOG.md