repotracer 1.0.1 → 2.1.1

package/README.md

@@ -1,6 +1,8 @@
 # repotracer
 
-RepoTracer is an MCP server whose `repo_scout` tool runs an isolated, read-only Luna process and returns validated source citations to Codex Sol.
+A repo investigator for Claude Code and Codex.
+
+RepoTracer installs an MCP tool named `repo_scout`. The coding agent can call it when a task needs repository investigation, then continue with the returned findings instead of spending the same conversation tracing the repo itself.
 
 ## Setup
 
@@ -8,50 +10,71 @@ RepoTracer is an MCP server whose `repo_scout` tool runs an isolated, read-only
 npx repotracer@latest setup
 ```
 
-The installer downloads the native binary, verifies its SHA-256 checksum, copies it to `~/.repotracer/bin/repotracer`, registers the stdio MCP server, and adds a managed routing block to `~/.codex/AGENTS.md`.
+Choose Claude Code, Codex, or both.
 
-Codex must already be installed, but you can set up RepoTracer before signing in.
-When a scout runs, RepoTracer reuses the current Codex login and provider instead
-of requiring another API key.
+RepoTracer uses the native CLI you are already signed into. A second provider login is not required for native investigations.
 
-```bash
-npm install -g @openai/codex
-npx repotracer@latest setup
-codex login
-repotracer doctor
-```
+Run the same command later to reconfigure or uninstall.
 
-Preview without changing files:
+## Commands
 
 ```bash
-npx repotracer@latest setup --dry-run
+npx repotracer@latest "where is authentication handled?"
+npx repotracer@latest scout "trace token refresh"
+npx repotracer@latest symbols "Config" --mode references
+npx repotracer@latest serve
+npx repotracer@latest doctor
+npx repotracer@latest status
+npx repotracer@latest update
+npx repotracer@latest uninstall --yes
 ```
 
-RepoTracer updates automatically. Restart Codex after an update for it to take
-effect. To disable automatic updates, set `updates.automatic = false` in
-`~/.repotracer/config.toml` or set `REPOTRACER_NO_UPDATE=1`. Running
-`npx repotracer@latest setup` still updates a disabled installation.
+`serve` starts the MCP server over stdio.
 
-## Commands
+`symbols` performs a local syntax lookup without a model call.
 
-```bash
-repotracer "where is auth handled?"
-repotracer scout "trace refresh token rotation"
-repotracer doctor
-repotracer status
-repotracer uninstall --yes
-```
+## Native investigators
+
+Claude Code and Codex investigations run through the corresponding native CLI.
+
+The investigator gets a separate conversation for the repository work. Related calls can continue that investigation instead of starting over, and independent investigations can run in parallel.
 
-## Permanent install
+Native investigations are **not** an enforced read-only sandbox. The underlying CLI can expose execution or filesystem capabilities beyond RepoTracer's own repository tools.
+
+For the current security model, read [SECURITY.md](https://github.com/repotracer/repotracer/blob/main/SECURITY.md).
+
+## When the investigator is unsure
+
+A result can preserve what was found, what was checked, and what remains unresolved.
+
+That lets Claude Code or Codex continue from useful partial work instead of repeating the investigation from scratch.
+
+## Custom OpenAI-compatible endpoint
 
 ```bash
-npm install -g repotracer
-# or
-cargo install --git https://github.com/repotracer/repotracer --locked repotracer
+npx repotracer@latest setup \
+  --base-url http://localhost:11434/v1 \
+  --model deepseek-coder
 ```
 
-Supported platforms: macOS arm64 and x64, Linux arm64 and x64, and Windows x64. Node.js 18 or newer.
+Set `REPOTRACER_API_KEY` when the endpoint requires authentication.
+
+Custom OpenAI-compatible models use RepoTracer's own repository-tool loop rather than the native Claude Code or Codex environment.
+
+## Requirements
+
+- Node.js 18 or newer for the `npx` launcher
+- `codex` for the Codex integration
+- `claude` for the Claude Code integration
+
+Published native packages target macOS arm64/x64, Linux arm64/x64, and Windows x64.
+
+## Documentation
 
-Read the [documentation and benchmarks](https://github.com/repotracer/repotracer).
+- [README](https://github.com/repotracer/repotracer)
+- [Benchmarks](https://github.com/repotracer/repotracer/blob/main/BENCHMARKS.md)
+- [Architecture](https://github.com/repotracer/repotracer/blob/main/docs/ARCHITECTURE.md)
+- [Claude Code and Codex integration](https://github.com/repotracer/repotracer/blob/main/docs/CLAUDE_CODE_INTEGRATION.md)
+- [Security](https://github.com/repotracer/repotracer/blob/main/SECURITY.md)
 
 MIT licensed.

package/bin/repotracer.js

@@ -34,8 +34,24 @@ function findBinary() {
   return candidates.find(candidate => fs.existsSync(candidate)) || null;
 }
 
+function topLevelCommand(args) {
+  const valuedOptions = new Set(['--root', '--config', '--model', '--base-url']);
+  const flags = new Set(['--json', '--mock', '--verbose', '-v']);
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (valuedOptions.has(arg)) {
+      index += 1;
+    } else if (valuedOptions.has(arg.split('=')[0]) || flags.has(arg)) {
+      continue;
+    } else {
+      return arg.startsWith('-') ? null : arg;
+    }
+  }
+  return null;
+}
+
 function persistForSetup(bin, args, home = os.homedir()) {
-  if (!path.isAbsolute(bin) || !args.includes('setup') || args.includes('--dry-run')) return bin;
+  if (!path.isAbsolute(bin) || !['setup', 'settings', 'reconfigure'].includes(topLevelCommand(args)) || args.includes('--dry-run')) return bin;
 
   const name = process.platform === 'win32' ? 'repotracer.exe' : 'repotracer';
   const directory = path.join(home, '.repotracer', 'bin');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "repotracer",
-  "version": "1.0.1",
-  "description": "Get up to 60% more from your Codex limits. A cheaper model searches your repo so Codex stops burning turns on it.",
+  "version": "2.1.1",
+  "description": "Read-only repository investigations for Codex and Claude Code using a separately configured scout model.",
   "bin": {
     "repotracer": "bin/repotracer.js"
   },