token-pilot 0.24.1 → 0.24.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +20 -0
- package/README.md +76 -14
- package/dist/agents/tp-api-surface-tracker.md +1 -1
- package/dist/agents/tp-audit-scanner.md +1 -1
- package/dist/agents/tp-commit-writer.md +1 -1
- package/dist/agents/tp-dead-code-finder.md +1 -1
- package/dist/agents/tp-debugger.md +1 -1
- package/dist/agents/tp-dep-health.md +1 -1
- package/dist/agents/tp-history-explorer.md +1 -1
- package/dist/agents/tp-impact-analyzer.md +1 -1
- package/dist/agents/tp-incident-timeline.md +1 -1
- package/dist/agents/tp-migration-scout.md +1 -1
- package/dist/agents/tp-onboard.md +1 -1
- package/dist/agents/tp-pr-reviewer.md +1 -1
- package/dist/agents/tp-refactor-planner.md +1 -1
- package/dist/agents/tp-review-impact.md +1 -1
- package/dist/agents/tp-run.md +1 -1
- package/dist/agents/tp-session-restorer.md +1 -1
- package/dist/agents/tp-test-coverage-gapper.md +1 -1
- package/dist/agents/tp-test-triage.md +1 -1
- package/dist/agents/tp-test-writer.md +1 -1
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "token-pilot",
|
|
3
|
-
"version": "0.24.
|
|
3
|
+
"version": "0.24.2",
|
|
4
4
|
"description": "Enforcement layer for token-efficient AI coding: MCP-first hook with structural denial summaries, SessionStart reminder, bless-agents CLI, and six tp-* subagents — works for every agent including those without MCP access.",
|
|
5
5
|
"author": "token-pilot",
|
|
6
6
|
"license": "MIT",
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,26 @@ All notable changes to Token Pilot will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.24.2] - 2026-04-18
|
|
9
|
+
|
|
10
|
+
### Changed — README manual-install section restored and expanded
|
|
11
|
+
|
|
12
|
+
In v0.20.2 I collapsed "Manual install" under a `<details>` to keep the README slim. That was overcorrection: users on Cursor / Codex / Cline / CI / team-shared configs had no quick "how do I add the MCP server?" answer visible.
|
|
13
|
+
|
|
14
|
+
Restored the section as a proper `## Manual MCP install` heading with **per-client examples**:
|
|
15
|
+
|
|
16
|
+
- **Claude Code** — both `claude mcp add` CLI and direct `.mcp.json` edit
|
|
17
|
+
- **Cursor** — `.cursor/mcp.json` example
|
|
18
|
+
- **Codex CLI** — `~/.codex/config.toml` TOML stanza
|
|
19
|
+
- **Cline (VS Code)** — `cline_mcp_settings.json` example
|
|
20
|
+
- **Any MCP-compatible client** — generic `command + args` pattern
|
|
21
|
+
- **Subagents install** (Claude-Code-only) — scope flags + `--force`
|
|
22
|
+
- **From source** — for contributors / vendored installs
|
|
23
|
+
|
|
24
|
+
Also added an env-var table (`TOKEN_PILOT_DENY_THRESHOLD`, `TOKEN_PILOT_ADAPTIVE_THRESHOLD`, `TOKEN_PILOT_BYPASS`, `TOKEN_PILOT_SKIP_POSTINSTALL`) — these used to be scattered across the codebase with no single reference.
|
|
25
|
+
|
|
26
|
+
Docs-only change. No code / test changes. 911 tests still green.
|
|
27
|
+
|
|
8
28
|
## [0.24.1] - 2026-04-18
|
|
9
29
|
|
|
10
30
|
### Fixed — two findings from v0.23.6 field verification
|
package/README.md
CHANGED
|
@@ -46,10 +46,35 @@ This does two things:
|
|
|
46
46
|
|
|
47
47
|
Restart your AI assistant to activate. The Read hook auto-installs the first time `token-pilot` starts inside Claude Code. Works with **Claude Code, Cursor, Codex, Antigravity, Cline**, and any MCP-compatible client.
|
|
48
48
|
|
|
49
|
-
|
|
50
|
-
<summary>Manual install (other MCP clients, from source, scripted CI)</summary>
|
|
49
|
+
## Manual MCP install (per-client examples)
|
|
51
50
|
|
|
52
|
-
|
|
51
|
+
If `init` isn't right for your setup — CI, non-TTY environments, editing a shared team config, or a client without an interactive installer — add Token Pilot as an MCP server directly. The server command is `npx -y token-pilot` on every client; only the config file shape differs.
|
|
52
|
+
|
|
53
|
+
### Claude Code
|
|
54
|
+
|
|
55
|
+
Two equivalent paths:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
# Via CLI (recommended — handles scope + scoping)
|
|
59
|
+
claude mcp add token-pilot -- npx -y token-pilot
|
|
60
|
+
claude mcp add --scope user token-pilot -- npx -y token-pilot
|
|
61
|
+
claude mcp add --scope project token-pilot -- npx -y token-pilot
|
|
62
|
+
|
|
63
|
+
# Or edit .mcp.json directly (project-level) / ~/.mcp.json (user-level)
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
```json
|
|
67
|
+
{
|
|
68
|
+
"mcpServers": {
|
|
69
|
+
"token-pilot": { "command": "npx", "args": ["-y", "token-pilot"] },
|
|
70
|
+
"context-mode": { "command": "npx", "args": ["-y", "claude-context-mode"] }
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### Cursor
|
|
76
|
+
|
|
77
|
+
Cursor reads `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
53
78
|
|
|
54
79
|
```json
|
|
55
80
|
{
|
|
@@ -59,27 +84,64 @@ Add to your `.mcp.json`:
|
|
|
59
84
|
}
|
|
60
85
|
```
|
|
61
86
|
|
|
62
|
-
|
|
87
|
+
### Codex CLI
|
|
63
88
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
89
|
+
Codex reads `~/.codex/config.toml`:
|
|
90
|
+
|
|
91
|
+
```toml
|
|
92
|
+
[mcp_servers.token-pilot]
|
|
93
|
+
command = "npx"
|
|
94
|
+
args = ["-y", "token-pilot"]
|
|
67
95
|
```
|
|
68
96
|
|
|
69
|
-
|
|
97
|
+
### Cline (VS Code)
|
|
98
|
+
|
|
99
|
+
Cline reads `cline_mcp_settings.json` (accessible via Cline panel → MCP Servers → Edit):
|
|
100
|
+
|
|
101
|
+
```json
|
|
102
|
+
{
|
|
103
|
+
"mcpServers": {
|
|
104
|
+
"token-pilot": { "command": "npx", "args": ["-y", "token-pilot"] }
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Any MCP-compatible client
|
|
110
|
+
|
|
111
|
+
Use the generic MCP protocol — the server is a plain stdio process:
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
command: npx
|
|
115
|
+
args: -y token-pilot
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
No env vars required. Optional overrides:
|
|
119
|
+
|
|
120
|
+
| Env var | Default | Purpose |
|
|
121
|
+
|---|---|---|
|
|
122
|
+
| `TOKEN_PILOT_DENY_THRESHOLD` | `300` | Line count above which the Read hook intervenes |
|
|
123
|
+
| `TOKEN_PILOT_ADAPTIVE_THRESHOLD` | `false` | Enable the adaptive curve as the session burns |
|
|
124
|
+
| `TOKEN_PILOT_BYPASS` | unset | Set to `1` to disable the Read hook for one session |
|
|
125
|
+
| `TOKEN_PILOT_SKIP_POSTINSTALL` | unset | Skip the `ast-index` safety-net install at `npm install` time |
|
|
126
|
+
|
|
127
|
+
### Subagents (Claude Code only)
|
|
128
|
+
|
|
129
|
+
`tp-*` subagents are a Claude Code feature. Other clients use only the MCP tools + Read hook. To install on a target scope explicitly:
|
|
70
130
|
|
|
71
131
|
```bash
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
#
|
|
132
|
+
npx token-pilot install-agents --scope=user # all projects
|
|
133
|
+
npx token-pilot install-agents --scope=project # this repo only
|
|
134
|
+
npx token-pilot install-agents --scope=user --force # re-apply after an update
|
|
75
135
|
```
|
|
76
136
|
|
|
77
|
-
|
|
137
|
+
### From source (contributors / vendored installs)
|
|
78
138
|
|
|
79
139
|
```bash
|
|
80
|
-
|
|
140
|
+
git clone https://github.com/Digital-Threads/token-pilot.git
|
|
141
|
+
cd token-pilot && npm install && npm run build
|
|
142
|
+
# Point your client's config at dist/index.js:
|
|
143
|
+
# "command": "node", "args": ["/abs/path/to/token-pilot/dist/index.js"]
|
|
81
144
|
```
|
|
82
|
-
</details>
|
|
83
145
|
|
|
84
146
|
## Modes
|
|
85
147
|
|
|
@@ -10,7 +10,7 @@ tools:
|
|
|
10
10
|
- mcp__token-pilot__smart_read
|
|
11
11
|
- mcp__token-pilot__smart_read_many
|
|
12
12
|
- mcp__token-pilot__read_section
|
|
13
|
-
token_pilot_version: "0.24.
|
|
13
|
+
token_pilot_version: "0.24.2"
|
|
14
14
|
token_pilot_body_hash: ae0b86eaffaf34bf283b94b5572481fa8c2d6a2a25193f1173b70bef0fbe1919
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -7,7 +7,7 @@ tools:
|
|
|
7
7
|
- mcp__token-pilot__read_diff
|
|
8
8
|
- mcp__token-pilot__outline
|
|
9
9
|
- mcp__token-pilot__read_symbol
|
|
10
|
-
token_pilot_version: "0.24.
|
|
10
|
+
token_pilot_version: "0.24.2"
|
|
11
11
|
token_pilot_body_hash: a058518619fd6e2def0c9226f6c70438a5e0a80efe680c935414ecd7e1b14a4f
|
|
12
12
|
---
|
|
13
13
|
|
package/dist/agents/tp-run.md
CHANGED
|
@@ -7,7 +7,7 @@ tools:
|
|
|
7
7
|
- mcp__token-pilot__read_range
|
|
8
8
|
- mcp__token-pilot__find_usages
|
|
9
9
|
- mcp__token-pilot__read_symbol
|
|
10
|
-
token_pilot_version: "0.24.
|
|
10
|
+
token_pilot_version: "0.24.2"
|
|
11
11
|
token_pilot_body_hash: 255912c47661d203c8f9a735237bc419f97e937f788a01811bbe126ee3dd5878
|
|
12
12
|
---
|
|
13
13
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "token-pilot",
|
|
3
|
-
"version": "0.24.
|
|
3
|
+
"version": "0.24.2",
|
|
4
4
|
"description": "Save up to 80% tokens when AI reads code — MCP server for token-efficient code navigation, AST-aware structural reading instead of dumping full files into context window",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|