token-goat 2.0.3 → 2.1.0

package/README.md

@@ -9,7 +9,7 @@ permalink: /
 
 ![Token-Goat](assets/logo.png)
 
-**85%** smaller reads · **97.4%** image compression · **130+** bash output filters · **94–99%** skill overhead cut · compaction memory · **prompt injection** guard · **3.7 GB** never reached the model · **1.1 Gt** tokens saved
+**85%** smaller reads · **97.4%** image compression · **160+** filter & interception rules · **94–99%** skill overhead cut · compaction memory · **prompt injection** guard · **3.7 GB** never reached the model · **1.1 Gt** tokens saved
 
 **Reduces AI token use/costs by 40–90%, and improves its focus. Fully automated, always online.**
 
@@ -72,6 +72,7 @@ The fastest way to reduce AI token costs is fixing these five, not writing short
 | Same docs URL fetched twice in a session | Re-fetch blocked at warm+ context pressure; cached body available via `token-goat web-output <id>` |
 | `cat src/auth.py` or `Get-Content module.py` run via Bash | Pre-Bash hook detects whole-file reads of indexed source files and suggests `token-goat read "file::Symbol"`, `skeleton`, or `section` — covers `cat`, `bat`, `type`, PowerShell `Get-Content`/`gc` |
 | `rg pattern src/` or `grep -rn` run via Bash (first time) | Pre-Bash hook suggests `token-goat symbol <name>` and `token-goat semantic "<query>"` as indexed alternatives to a full directory walk |
+| `rg "^def" src/file.py` or `grep "class " module.ts` — structural search on a single source file | Pre-Bash hook redirects to `token-goat skeleton "file"` or `outline "file"` — all symbols with line numbers, no full-file read |
 | `rg` or `grep` run twice with the same pattern | Pre-Bash dedup hint fires on repeated `rg`/`grep`/`ag` calls the same way it fires on the native Grep tool; repeat searches return a cached match-count hint instead of re-running |
 | Read tool targets `tool-results/<id>.txt` or `tasks/<id>.output` | Pre-Read hook suggests `token-goat bash-output <id> --tail N` / `--grep PATTERN` / `--section H`; the filename stem is the output ID |
 | Repeated monitoring command run again (`gh run watch`, `next dev`, `vitest`, `docker logs`) | Pre-bash recall hint: when a prior run is cached and its output exceeds 2 KB, a pointer to `token-goat bash-output <id> --grep PATTERN` is injected instead of re-running the command |
@@ -239,7 +240,7 @@ FAILED tests/test_x.py::test_one
 [token-goat: pytest filter compressed 4.8 KiB to 0.1 KiB (97% saved)]
 ```
 
-130 built-in filters cover the noisiest dev commands: `pytest`, `jest` / `vitest`, `cargo`, `npm` / `pnpm` / `yarn` / `bun`, `docker`, `kubectl` / `helm`, `aws`, `ruff` / `eslint` / `mypy` / `pylint` / `oxlint`, `git`, `make` / `gradle` / `mvn` / `ant` / `bazel`, `go test` / `golangci-lint`, `terraform` / `pulumi` / `cdk`, `pip` / `uv` / `conda`, `python`, `gh`, `ansible`, `pre-commit`, `grep`, `eza` / `ls`, `fd`, `bat`, `jq`, `yq`, `curl` / `wget`, `rsync`, `dotnet`, `cmake` / `ctest`, `swift` / `xcodebuild`, `ruby` / `bundler`, `elixir` / `mix`, `php` / `composer`, `flutter` / `dart`, `rust` / `cargo`, `kotlin` / `ktlint`, `zig`, `crystal`, `haskell` / `cabal`, `nix`, `R`, `c++` (conan / vcpkg / cppcheck / clang-tidy), `wrangler` / `hardhat` / `serverless`, `erlang`, `fly.io`, `forge`, `elm`, `julia`, `tox`, `vault`, `packer`, `nx` / `lerna` / `turbo`, `prettier` / `biome`, `sass`, `wasm-pack`, `deno`, **and AI tool CLIs**: `aider`, `gemini`, `claude`, `gh copilot`, `copilot`, `cursor`, `windsurf` (incl. Cascade), `opencode`, `continue`, `cline`. Each filter strips ANSI escapes, collapses `\r` progress bars, dedupes repeated lines, groups linter issues by rule, keeps every error block verbatim, and caps total output at 1000 lines / 64 KiB. Compound commands (`cmd1 && cmd2`) are wrapped per segment, so `git diff && git log` compresses both halves. Disable globally with `TOKEN_GOAT_BASH_COMPRESS=0`, per-filter via `[bash_compress] disabled_filters = ["docker"]` in config.toml, or preview the output of any command with `token-goat compress --cmd '<your command>'`. To exclude project-specific directories from indexing (temporary venvs, build sandboxes), add `[indexing] skip_dirs = ["my-tmpdir"]` to config.toml.
+Built-in output compression covers 130+ dev tool CLIs: `pytest`, `jest` / `vitest`, `cargo`, `npm` / `pnpm` / `yarn` / `bun`, `docker`, `kubectl` / `helm`, `aws`, `ruff` / `eslint` / `mypy` / `pylint` / `oxlint`, `git`, `make` / `gradle` / `mvn` / `ant` / `bazel`, `go test` / `golangci-lint`, `terraform` / `pulumi` / `cdk`, `pip` / `uv` / `conda`, `python`, `gh`, `ansible`, `pre-commit`, `grep`, `eza` / `ls`, `fd`, `bat`, `jq`, `yq`, `curl` / `wget`, `rsync`, `dotnet`, `cmake` / `ctest`, `swift` / `xcodebuild`, `ruby` / `bundler`, `elixir` / `mix`, `php` / `composer`, `flutter` / `dart`, `rust` / `cargo`, `kotlin` / `ktlint`, `zig`, `crystal`, `haskell` / `cabal`, `nix`, `R`, `c++` (conan / vcpkg / cppcheck / clang-tidy), `wrangler` / `hardhat` / `serverless`, `erlang`, `fly.io`, `forge`, `elm`, `julia`, `tox`, `vault`, `packer`, `nx` / `lerna` / `turbo`, `prettier` / `biome`, `sass`, `wasm-pack`, `deno`, **and AI tool CLIs**: `aider`, `gemini`, `claude`, `gh copilot`, `copilot`, `cursor`, `windsurf` (incl. Cascade), `opencode`, `continue`, `cline`. Each filter strips ANSI escapes, collapses `\r` progress bars, dedupes repeated lines, groups linter issues by rule, keeps every error block verbatim, and caps total output at 1000 lines / 64 KiB. Compound commands (`cmd1 && cmd2`) are wrapped per segment, so `git diff && git log` compresses both halves. Disable globally with `TOKEN_GOAT_BASH_COMPRESS=0`, per-filter via `[bash_compress] disabled_filters = ["docker"]` in config.toml, or preview the output of any command with `token-goat compress --cmd '<your command>'`. To exclude project-specific directories from indexing (temporary venvs, build sandboxes), add `[indexing] skip_dirs = ["my-tmpdir"]` to config.toml.
 
 `gh api` responses get an extra pass: boilerplate `*_url` fields (`followers_url`, `gists_url`, `starred_url`, and around a dozen others) are stripped from JSON objects; `html_url`, `avatar_url`, `clone_url`, and `ssh_url` are kept. User and repo objects typically shrink 60–80%. When token-goat sees a GitHub permission error in the output or a non-zero exit on a security endpoint, it injects a system message suggesting `gh auth refresh -s security_events`.
 

package/dist/token-goat.mjs

@@ -9493,7 +9493,7 @@ init_define_import_meta_env();
 import { createRequire } from "node:module";
 function resolveVersion() {
   if (true) {
-    return "2.0.3";
+    return "2.1.0";
   }
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");
@@ -10567,6 +10567,10 @@ var BUILD_COMMAND_PATTERNS = [
   // Turbo
   /^\s*turbo\s+(build|dev)\b/i
 ];
+var LOCK_FILE_COUNT = LOCK_FILE_NAMES.size;
+var MANIFEST_FILE_COUNT = MANIFEST_FILE_NAMES.size + MANIFEST_EXTENSIONS.size + MANIFEST_BASENAME_PATTERNS.length;
+var BUILD_DIR_COUNT = BUILD_DIR_NAMES.size;
+var GENERATED_EXT_COUNT = ALWAYS_GENERATED_EXTS.size + CONDITIONALLY_GENERATED_EXTS.size;
 function isLockFile(basename7) {
   return LOCK_FILE_NAMES.has(basename7.toLowerCase());
 }
@@ -11845,6 +11849,8 @@ function isTsConfigFile(basename7) {
   return /^tsconfig(\..+)?\.json$/i.test(lower) || lower === "jsconfig.json";
 }
 var LARGE_FILE_BYTES = 100 * 1024;
+var REREAD_DENY_BYTES = 50 * 1024;
+var LARGE_FILE_DENY_BYTES = 500 * 1024;
 function isNodeModulesPath(path15) {
   const isWindows = process.platform === "win32";
   const check = isWindows ? path15.toLowerCase() : path15;
@@ -11925,6 +11931,13 @@ function preReadHandler(event) {
       }
     }
   }
+  if (/^\.env(\.\w+)?$/.test(basename7) && wasFileReadThisSession(normalized)) {
+    recordFileRead(normalized);
+    recordStat("session_hint", 0, 0);
+    return denyOutput(
+      normalized + " was already read this session. Environment files rarely change mid-session. Use `token-goat config-get " + normalized + " KEY_NAME` to extract a specific variable."
+    );
+  }
   if (wasFileReadThisSession(normalized)) {
     const entry = getSessionFiles().get(normalized);
     const reads = entry?.readCount ?? 1;
@@ -11933,6 +11946,11 @@ function preReadHandler(event) {
     const hint = _isDocFile(normalized) ? 'Use `token-goat section "' + normalized + '::SectionName"` to read one section.' : "Use token-goat read/section/symbol to re-read surgically.";
     const rereadBytes = statSize(normalized) ?? 0;
     recordStat("session_hint", rereadBytes, Math.round(rereadBytes / 4));
+    if (rereadBytes >= REREAD_DENY_BYTES || reads >= 2) {
+      return denyOutput(
+        normalized + " was already read this session (" + reads + " " + plural + "). " + hint
+      );
+    }
     return contextOutput(
       "Note: " + normalized + " was already read this session (" + reads + " " + plural + "). " + hint
     );
@@ -11943,6 +11961,11 @@ function preReadHandler(event) {
     recordFileRead(normalized);
     const hint = _isDocFile(normalized) ? 'Use `token-goat section "' + normalized + '::SectionName"` to read one section.' : "Consider token-goat skeleton or token-goat section.";
     recordStat("session_hint", size, Math.round(size / 4));
+    if (size >= LARGE_FILE_DENY_BYTES) {
+      return denyOutput(
+        normalized + " is very large (" + kb + "KB). " + hint + " Use Read with offset/limit to sample specific sections."
+      );
+    }
     return contextOutput(
       "Note: " + normalized + " is large (" + kb + "kb). " + hint
     );
@@ -12489,10 +12512,125 @@ function extractCommand(event) {
   const cmd = event.toolInput["command"];
   return typeof cmd === "string" && cmd.trim() !== "" ? cmd.trim() : void 0;
 }
+function isTempPath(fp) {
+  const norm = fp.replace(/\\/g, "/");
+  return /^\/tmp\//i.test(norm) || /\/var\/folders\//i.test(norm) || /AppData\/Local\/Temp\//i.test(norm) || norm.startsWith("/c/Users/") && norm.includes("/AppData/Local/Temp/");
+}
+function isOrchestratorStateFile(filePath) {
+  const basename7 = (filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1)) ?? filePath;
+  return /^\.improve-state-/.test(basename7);
+}
 function extractCatSourceFile(cmd) {
   const m = /^cat\s+(\S+\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj))\s*$/.exec(cmd);
   return m?.[1] ?? null;
 }
+function extractCatFile(cmd) {
+  const m = /^cat(?:\s+(?:-[a-zA-Z]+|--[a-zA-Z-]+))*\s+(?:"([^"]+)"|'([^']+)'|(\S+))\s*$/.exec(cmd);
+  if (!m) return null;
+  const filePath = m[1] ?? m[2] ?? m[3];
+  if (filePath === void 0) return null;
+  if (isTempPath(filePath)) return null;
+  const basename7 = filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1) ?? filePath;
+  const isEnvFile = /^\.env(\.\w+)?$/i.test(basename7);
+  const hasKnownExt = /\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties|sql|env)$/i.test(filePath);
+  if (!hasKnownExt && !isEnvFile) return null;
+  const isDoc = /\.(?:md|mdx|rst|txt|sql)$/i.test(filePath);
+  const isEnv = isEnvFile || /\.env$/i.test(filePath);
+  const isConfig = /\.(?:json|yaml|yml|toml|conf|cfg|ini|properties)$/i.test(filePath);
+  return { filePath, isDoc, isEnv, isConfig };
+}
+function extractWslCatFile(cmd) {
+  const wslMatch = /^wsl(?:\s+-d\s+\S+)?\s+bash\s+-c\s+"cat(?:\s+(?:-[a-zA-Z]+|--[a-zA-Z-]+))*\s+\/mnt\/([a-z])\/([^"]*)"/.exec(cmd);
+  if (!wslMatch) return null;
+  const drive = wslMatch[1]?.toUpperCase();
+  const pathRest = wslMatch[2];
+  if (!drive || !pathRest) return null;
+  const filePath = drive + ":/" + pathRest;
+  if (isTempPath(filePath)) return null;
+  const basename7 = filePath.includes("/") ? filePath.split("/").at(-1) : filePath.split("\\").at(-1) ?? filePath;
+  const isEnvFile = /^\.env(\.\w+)?$/i.test(basename7);
+  const hasKnownExt = /\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties|sql|env)$/i.test(filePath);
+  if (!hasKnownExt && !isEnvFile) return null;
+  const isDoc = /\.(?:md|mdx|rst|txt|sql)$/i.test(filePath);
+  const isEnv = isEnvFile || /\.env$/i.test(filePath);
+  const isConfig = /\.(?:json|yaml|yml|toml|conf|cfg|ini|properties)$/i.test(filePath);
+  return { filePath, isDoc, isEnv, isConfig };
+}
+function extractPythonFileRead(cmd) {
+  if (!/python3?/.test(cmd)) return null;
+  const EXT = /\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties)/i;
+  const direct = /open\(['"]([^'"]+\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties))['"]/i.exec(cmd);
+  if (direct) {
+    const filePath = direct[1] ?? "";
+    if (!filePath) return null;
+    if (isOrchestratorStateFile(filePath)) return null;
+    const isDoc = /\.(?:md|mdx|rst|txt)$/i.test(filePath);
+    return { filePath, isDoc };
+  }
+  if (/open\s*\(/.test(cmd)) {
+    const literal = /['"]([^'"]+\.(?:java|py|ts|tsx|js|jsx|go|rb|rs|cpp|cc|cxx|c|h|hpp|kt|swift|cs|php|scala|clj|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties))['"]/i.exec(cmd);
+    if (literal) {
+      const filePath = literal[1] ?? "";
+      if (filePath) {
+        if (isOrchestratorStateFile(filePath)) return null;
+        if (EXT.test(filePath)) {
+          const isDoc = /\.(?:md|mdx|rst|txt)$/i.test(filePath);
+          return { filePath, isDoc };
+        }
+      }
+    }
+  }
+  return null;
+}
+function extractHeadFile(cmd) {
+  const m = /^head(?:\s+-n\s+(\d+)|\s+-(\d+))?\s+(?:"([^"]+)"|'([^']+)'|(\S+))\s*$/.exec(cmd);
+  if (!m) return null;
+  const n = parseInt(m[1] ?? m[2] ?? "0", 10);
+  if (n > 0 && n < 10) return null;
+  const filePath = m[3] ?? m[4] ?? m[5];
+  if (filePath === void 0) return null;
+  if (isTempPath(filePath)) return null;
+  if (!/\.(?:ts|tsx|js|jsx|py|go|java|rs|rb|cs|md|mdx|rst|txt|json|yaml|yml|toml|sql|sh)$/i.test(filePath)) return null;
+  const isDoc = /\.(?:md|mdx|rst|txt|sql)$/i.test(filePath);
+  const isConfig = /\.(?:json|yaml|yml|toml|conf|cfg|ini|properties)$/i.test(filePath);
+  return { filePath, isDoc, isConfig };
+}
+function extractNodeFileRead(cmd) {
+  if (!/^node\s+-e/.test(cmd)) return null;
+  const m = /readFileSync\(['"]([^'"]+\.(?:ts|tsx|js|jsx|py|go|java|rs|rb|cs|md|mdx|rst|txt|json|yaml|yml|toml|xml|conf|cfg|ini|properties|sql))['"]/i.exec(cmd);
+  if (!m || !m[1]) return null;
+  const filePath = m[1];
+  if (isOrchestratorStateFile(filePath)) return null;
+  if (isTempPath(filePath)) return null;
+  const isDoc = /\.(?:md|mdx|rst|txt|sql)$/i.test(filePath);
+  return { filePath, isDoc };
+}
+function extractTailFile(cmd) {
+  if (/-f\b/.test(cmd)) return null;
+  if (/-c\b/.test(cmd)) return null;
+  if (/-n\s*\+/.test(cmd)) return null;
+  const m = /^tail(?:\s+-n\s+(\d+)|\s+-(\d+))?\s+(?:"([^"]+)"|'([^']+)'|(\S+))\s*$/.exec(cmd);
+  if (!m) return null;
+  const n = parseInt(m[1] ?? m[2] ?? "0", 10);
+  if (n <= 10) return null;
+  const filePath = m[3] ?? m[4] ?? m[5];
+  if (!filePath) return null;
+  if (isTempPath(filePath)) return null;
+  if (!/\.(?:ts|tsx|js|jsx|py|go|java|rs|rb|cs|md|mdx|rst|txt|json|yaml|yml|toml|sql|sh)$/i.test(filePath)) return null;
+  const isDoc = /\.(?:md|mdx|rst|txt|sql)$/i.test(filePath);
+  return { filePath, isDoc };
+}
+function extractRgStructuralSearch(cmd) {
+  if (!/^(?:rg|grep)\s+/.test(cmd)) return null;
+  const hasStructural = /["']?\^?(?:def\s|class\s|function\s|func\s|fn\s|pub fn\s|import\s|from\s)/.test(cmd) || /["']\^(?:def|class|function|func|import|from)["']/.test(cmd) || /\\bdef\\b|\\bclass\\b/.test(cmd);
+  if (!hasStructural) return null;
+  const fileMatch = /(?:^|\s)(?:"([^"]+\.(?:py|ts|tsx|js|jsx|go|rs|rb|cs|java|cpp|cc|cxx|c|h|sh|bash))"|('([^']+\.(?:py|ts|tsx|js|jsx|go|rs|rb|cs|java|cpp|cc|cxx|c|h|sh|bash))')|([^\s"']+\.(?:py|ts|tsx|js|jsx|go|rs|rb|cs|java|cpp|cc|cxx|c|h|sh|bash)))\s*$/.exec(cmd);
+  if (!fileMatch) return null;
+  const filePath = fileMatch[1] ?? fileMatch[3] ?? fileMatch[4];
+  if (!filePath) return null;
+  if (isTempPath(filePath)) return null;
+  return { filePath };
+}
 function isTscCommand(cmd) {
   return /^\s*tsc(\s|$)/i.test(cmd);
 }
@@ -12512,6 +12650,56 @@ function buildRecallHint(cmd, outputId) {
 function preBashHandler(event) {
   const cmd = extractCommand(event);
   if (cmd === void 0) return passOutput();
+  const catResult = extractCatFile(cmd);
+  if (catResult !== null) {
+    const { filePath, isDoc, isEnv, isConfig } = catResult;
+    const hint = isEnv ? 'Use `token-goat config-get "' + filePath + '" KEY_NAME` to read a specific variable.' : isConfig ? 'Use `token-goat config-get "' + filePath + '" KEY_NAME` or `token-goat section "' + filePath + '::sectionName"` to read a specific value.' : isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` to read one function or class.';
+    recordStat("session_hint", 0, 0);
+    return denyOutput("`cat` loads the entire file into context. " + hint);
+  }
+  const wslCatResult = extractWslCatFile(cmd);
+  if (wslCatResult !== null) {
+    const { filePath, isDoc, isEnv, isConfig } = wslCatResult;
+    const hint = isEnv ? 'Use `token-goat config-get "' + filePath + '" KEY_NAME` to read a specific variable.' : isConfig ? 'Use `token-goat config-get "' + filePath + '" KEY_NAME` or `token-goat section "' + filePath + '::sectionName"` to read a specific value.' : isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` to read one function or class.';
+    recordStat("session_hint", 0, 0);
+    return denyOutput("`cat` loads the entire file into context. " + hint);
+  }
+  const pyRead = extractPythonFileRead(cmd);
+  if (pyRead !== null) {
+    const { filePath, isDoc } = pyRead;
+    const hint = isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` to extract a specific symbol.';
+    recordStat("session_hint", 0, 0);
+    return denyOutput("Python `open()` file reads bypass read hooks. " + hint);
+  }
+  const tailResult = extractTailFile(cmd);
+  if (tailResult !== null) {
+    const { filePath, isDoc } = tailResult;
+    const hint = isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` or `token-goat skeleton "' + filePath + '"` to see the file structure.';
+    recordStat("session_hint", 0, 0);
+    return contextOutput("`tail` bypasses read hooks. " + hint);
+  }
+  const headResult = extractHeadFile(cmd);
+  if (headResult !== null) {
+    const { filePath, isDoc, isConfig } = headResult;
+    const hint = isConfig ? 'Use `token-goat config-get "' + filePath + '" KEY_NAME` or `token-goat section "' + filePath + '::sectionName"` to read a specific value.' : isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` or `token-goat skeleton "' + filePath + '"` to see the file structure.';
+    recordStat("session_hint", 0, 0);
+    return contextOutput("`head` bypasses read hooks. " + hint);
+  }
+  const nodeRead = extractNodeFileRead(cmd);
+  if (nodeRead !== null) {
+    const { filePath, isDoc } = nodeRead;
+    const hint = isDoc ? 'Use `token-goat section "' + filePath + '::SectionHeading"` to read one section.' : 'Use `token-goat read "' + filePath + '::SymbolName"` to extract a specific symbol.';
+    recordStat("session_hint", 0, 0);
+    return denyOutput("Node.js `fs.readFileSync()` bypasses read hooks. " + hint);
+  }
+  const rgStructural = extractRgStructuralSearch(cmd);
+  if (rgStructural !== null) {
+    const { filePath } = rgStructural;
+    recordStat("session_hint", 0, 0);
+    return contextOutput(
+      'Searching for code definitions with `rg`/`grep` is slower than surgical reads. Use `token-goat skeleton "' + filePath + '"` to see all symbols with line numbers, or `token-goat outline "' + filePath + '"` for symbols with docstrings and line ranges.'
+    );
+  }
   const monitoringHint = getMonitoringRecallHint(cmd);
   if (monitoringHint !== null) {
     const monCmdHash = fingerprintContent(cmd).slice(0, 16);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-goat",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Surgical token-reduction companion for Claude Code and other AI coding agents",
   "type": "module",
   "main": "./dist/token-goat.mjs",