microsoft/TokenEconomizer

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/microsoft/TokenEconomizer.svg?style=card)](https://bestofgithub.dev/repo/microsoft/TokenEconomizer)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/microsoft/TokenEconomizer.svg)](https://bestofgithub.dev/repo/microsoft/TokenEconomizer)

Loading README…

Agent	Update
Claude Code, Copilot CLI, opencode	`git pull` in the clone
Codex	`git pull` in the clone, then the `codex plugin add` line again
Pi	`pi update --extensions`

Agent	Supported	Older versions
Claude Code	2.1.300 to 2.1.310	not supported
Codex	0.153.1 to 0.164.0	not supported
Copilot CLI	1.0.83 to 1.0.102	not supported
Pi	1.2.0 to 1.3.0	0.99.x: load the extension by path (below)
opencode (experimental)	1.19.5 and 2.2.0	not tested

Agent	Type a command as
Claude Code, Copilot CLI	`/tokeneconomizer:<command>`
Codex	`$tokeneconomizer:<command>`
Pi	`/te <command>`
opencode	from a terminal: `~/.tokeneconomizer/bin/te --host opencode <command>`
a terminal, in the repository	`~/.tokeneconomizer/bin/te <command>`

Command	What it does
`status`	what it learned and did here, and what your sessions cost
`microskills`	the facts it injects, and those still forming
`toolprune`	the tools it left out, and the evidence (not on Pi or opencode)
`toolprune restore`	give them back; they will not be removed again
`config`	every setting in effect
`config set microskills=on`	turn a mechanism on (or `=off`) in this repository; add `--global` for every repository

	Setting	Default	What it sets
k	`microskills_propose_every`	3	sessions between runs of micro-skills' fact proposer
p	`toolprune_evidence`	10	prompts a tool must go unused before it is left out
m	`toolprune_min_sessions`	2	sessions those prompts must span
s	`toolprune_sessions`	5	or this many sessions, of any length
q	`toolprune_quiet_minutes`	60	minutes your sessions here must be idle before a deny list is written
e	`loopguard.envelope_min_samples`	5	turns here that ended well (no failing check after the last edit) before the loop guard acts
c	`loopguard.judge_confidence`	0.7	how sure the judge must be that a turn is stuck
r	`loopguard_nudges`	1	redirects per turn before the guard only tells you
b	`loopguard.backstop_mult`	2.5	how many times its usual length a churning turn may run before it is redirected without the judge

TokenEconomizer: Experience-Driven Black-Box Cost Control for Coding Agents

Agent	Tool pruning leaves out	Written to
Claude Code	single tools	`.claude/settings.local.json`
Codex	capability packages	`.codex/config.toml`
Copilot CLI	whole MCP servers	`.github/copilot/settings.local.json`
Pi	nothing (Pi loads only four tools)	—
opencode	nothing yet	—

Agent	Interactive: where it shows	How to stop	Headless: where it shows	How to stop
Claude Code	in Claude's reply	Esc	in the final reply	Ctrl+C
Codex	in the conversation	Esc, then `/stop`	not shown	Ctrl+C
Copilot CLI	in the conversation	Esc twice	on stdout	Ctrl+C
Pi	as a notification	Esc	on stderr	Ctrl+C
opencode	as a notification	Esc	on stderr	Ctrl+C


`tokeneconomizer/microskills`	Micro-skill synthesis and injection: facts learned from finished sessions
`tokeneconomizer/toolprune`	Tool pruning: unused tools and Codex capability packages
`tokeneconomizer/loopguard`	Failure-loop intervention: the per-call guard and its per-repository envelope
`tokeneconomizer/trace`	Each agent's session log, read into one shape
`tokeneconomizer/plugin`	The runtime the hooks and the `te` command run
`plugin`	The installable plugin: manifests, hook files, launchers, slash commands, the Pi extension, the opencode plugin
`experiments`	The harness, launchers and task sets behind the paper's results
`docs`	`PLUGIN.md` (design, verified agent behavior) and `ARCHITECTURE.md` (how the package fits together)
`tests`	Offline tests for the package and the plugin