repotracer 2.1.0 → 2.1.1

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.
Files changed (2) hide show
  1. package/README.md +47 -65
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,8 @@
1
1
  # repotracer
2
2
 
3
- RepoTracer is an MCP server for read-only repository investigations in Codex
4
- and Claude Code. Its `repo_scout` tool returns a model-authored report with
5
- source excerpts and validated file citations. Citation validation checks that
6
- locations exist inside the selected repository; it does not prove the report's
7
- conclusions.
3
+ A repo investigator for Claude Code and Codex.
4
+
5
+ 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.
8
6
 
9
7
  ## Setup
10
8
 
@@ -12,87 +10,71 @@ conclusions.
12
10
  npx repotracer@latest setup
13
11
  ```
14
12
 
15
- In an interactive terminal, the v2 setup wizard lets you choose Codex, Claude
16
- Code, or both, then choose a scout model. Defaults are:
13
+ Choose Claude Code, Codex, or both.
17
14
 
18
- - Codex parent -> Codex scout: `gpt-5.6-luna`
19
- - Claude Code parent -> Claude scout: `sonnet`
15
+ RepoTracer uses the native CLI you are already signed into. A second provider login is not required for native investigations.
20
16
 
21
- These are defaults, not cost or quality promises. RepoTracer uses each native
22
- CLI's existing login. It does not require a second subscription key.
17
+ Run the same command later to reconfigure or uninstall.
23
18
 
24
- For scripted setup:
19
+ ## Commands
25
20
 
26
21
  ```bash
27
- npx repotracer@latest setup --agents codex
28
- npx repotracer@latest setup --agents claude
29
- npx repotracer@latest setup --agents both --dry-run
22
+ npx repotracer@latest "where is authentication handled?"
23
+ npx repotracer@latest scout "trace token refresh"
24
+ npx repotracer@latest symbols "Config" --mode references
25
+ npx repotracer@latest serve
26
+ npx repotracer@latest doctor
27
+ npx repotracer@latest status
28
+ npx repotracer@latest update
29
+ npx repotracer@latest uninstall --yes
30
30
  ```
31
31
 
32
- The Codex integration requires the `codex` executable. The Claude Code
33
- integration requires `claude`. Setup checks that the executable is available;
34
- the native CLI handles authentication when a scout runs. Restart the parent
35
- agent after setup.
32
+ `serve` starts the MCP server over stdio.
36
33
 
37
- ## Settings
34
+ `symbols` performs a local syntax lookup without a model call.
38
35
 
39
- ```bash
40
- npx repotracer@latest settings
41
- ```
36
+ ## Native investigators
42
37
 
43
- The TUI uses two steps. First choose the parent integrations. Then accept
44
- recommended models or keep saved choices. Open `Advanced` to search and
45
- review a different provider/model for each parent. The
46
- Custom API form accepts a base URL, model ID, and optional API key. Keys
47
- require HTTPS; unauthenticated local endpoints can use HTTP. Use the flags
48
- below for native model IDs. Esc and Ctrl-C cancel, and nothing is written
49
- before the final save.
38
+ Claude Code and Codex investigations run through the corresponding native CLI.
50
39
 
51
- For automation, use explicit settings flags:
40
+ 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.
52
41
 
53
- ```bash
54
- npx repotracer@latest settings --agents both \
55
- --codex-scout codex --codex-model gpt-5.6-luna \
56
- --claude-scout claude --claude-model sonnet
57
- ```
42
+ Native investigations are **not** an enforced read-only sandbox. The underlying CLI can expose execution or filesystem capabilities beyond RepoTracer's own repository tools.
58
43
 
59
- Use `--dry-run` to preview changes. Parent profiles are independent.
44
+ For the current security model, read [SECURITY.md](https://github.com/repotracer/repotracer/blob/main/SECURITY.md).
60
45
 
61
- ## Commands
46
+ ## When the investigator is unsure
47
+
48
+ A result can preserve what was found, what was checked, and what remains unresolved.
49
+
50
+ That lets Claude Code or Codex continue from useful partial work instead of repeating the investigation from scratch.
51
+
52
+ ## Custom OpenAI-compatible endpoint
62
53
 
63
54
  ```bash
64
- npx repotracer@latest "where is authentication handled?"
65
- npx repotracer@latest scout "trace token refresh" --intent diagnose
66
- npx repotracer@latest symbols "Config" --mode references
67
- npx repotracer@latest serve
68
- npx repotracer@latest doctor
69
- npx repotracer@latest status
70
- npx repotracer@latest update
71
- npx repotracer@latest uninstall --yes
55
+ npx repotracer@latest setup \
56
+ --base-url http://localhost:11434/v1 \
57
+ --model deepseek-coder
72
58
  ```
73
59
 
74
- `serve` runs the MCP server over stdio. `symbols` performs a local syntax
75
- lookup without a model call. Add `--json` to `scout`, `doctor`, or `status`.
60
+ Set `REPOTRACER_API_KEY` when the endpoint requires authentication.
61
+
62
+ Custom OpenAI-compatible models use RepoTracer's own repository-tool loop rather than the native Claude Code or Codex environment.
76
63
 
77
- The MCP tool requires `query`; `repository`, `focus`, and `investigation` are
78
- optional. Related follow-ups can pass the returned
79
- `conversation.id` as `investigation.conversation_id`. Claude uses Read, Grep,
80
- and Glob; Codex uses a read-only shell and optional Symbols lookup. Neither
81
- scout receives editing tools or external MCP servers.
64
+ ## Requirements
82
65
 
83
- ## Timeouts and support
66
+ - Node.js 18 or newer for the `npx` launcher
67
+ - `codex` for the Codex integration
68
+ - `claude` for the Claude Code integration
84
69
 
85
- Warm provider processes may be retained for related work. `session.idle_secs`
86
- retires an inactive warm process; it is not a total request timeout. The
87
- optional `model.timeout_ms` limit measures stream inactivity, while
88
- `explorer.timeout_seconds` limits a whole investigation only in the generic
89
- OpenAI-compatible engine, not the native scouts. Both default to zero.
70
+ Published native packages target macOS arm64/x64, Linux arm64/x64, and Windows x64.
90
71
 
91
- Node.js 18 or newer is required for the launcher. Published native packages
92
- target macOS arm64 and x64, Linux arm64 and x64, and Windows x64. The v2
93
- release candidate has passed GitHub CI on Linux, macOS, and Windows.
72
+ ## Documentation
94
73
 
95
- RepoTracer does not promise lower cost, faster completion, or a particular
96
- answer quality. Provider and parent-agent behavior affect each result.
74
+ - [README](https://github.com/repotracer/repotracer)
75
+ - [Benchmarks](https://github.com/repotracer/repotracer/blob/main/BENCHMARKS.md)
76
+ - [Architecture](https://github.com/repotracer/repotracer/blob/main/docs/ARCHITECTURE.md)
77
+ - [Claude Code and Codex integration](https://github.com/repotracer/repotracer/blob/main/docs/CLAUDE_CODE_INTEGRATION.md)
78
+ - [Security](https://github.com/repotracer/repotracer/blob/main/SECURITY.md)
97
79
 
98
- MIT licensed. See the [repository documentation](https://github.com/repotracer/repotracer).
80
+ MIT licensed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "repotracer",
3
- "version": "2.1.0",
3
+ "version": "2.1.1",
4
4
  "description": "Read-only repository investigations for Codex and Claude Code using a separately configured scout model.",
5
5
  "bin": {
6
6
  "repotracer": "bin/repotracer.js"