seer-mcp 0.1.7 → 0.1.9

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 (29) hide show
  1. package/README.md +53 -25
  2. package/dist/cli/index.js +139 -168
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/cli/init.d.ts +15 -0
  5. package/dist/cli/init.d.ts.map +1 -1
  6. package/dist/cli/init.js +368 -68
  7. package/dist/cli/init.js.map +1 -1
  8. package/dist/indexer/discovery.d.ts.map +1 -1
  9. package/dist/indexer/discovery.js +9 -2
  10. package/dist/indexer/discovery.js.map +1 -1
  11. package/dist/indexer/freshness.d.ts.map +1 -1
  12. package/dist/indexer/freshness.js +26 -1
  13. package/dist/indexer/freshness.js.map +1 -1
  14. package/dist/indexer/index.d.ts.map +1 -1
  15. package/dist/indexer/index.js +28 -9
  16. package/dist/indexer/index.js.map +1 -1
  17. package/dist/indexer/protoScanner.d.ts.map +1 -1
  18. package/dist/indexer/protoScanner.js +43 -6
  19. package/dist/indexer/protoScanner.js.map +1 -1
  20. package/dist/indexer/serviceHostScanner.d.ts +7 -7
  21. package/dist/indexer/serviceHostScanner.d.ts.map +1 -1
  22. package/dist/indexer/serviceHostScanner.js +41 -25
  23. package/dist/indexer/serviceHostScanner.js.map +1 -1
  24. package/dist/indexer/skeleton.js +3 -3
  25. package/dist/indexer/skeleton.js.map +1 -1
  26. package/dist/mcp/server.d.ts.map +1 -1
  27. package/dist/mcp/server.js +6 -5
  28. package/dist/mcp/server.js.map +1 -1
  29. package/package.json +3 -2
package/README.md CHANGED
@@ -36,34 +36,62 @@ Oh, and Seer can absolutely help agents find their way inside large, messy repos
36
36
 
37
37
  ---
38
38
 
39
- ## Quick Start
40
-
41
- One command, from inside the repo you want indexed (needs Node 24+):
42
-
43
- ```bash
44
- npx seer-mcp init
45
- ```
46
-
47
- If you use **Google Antigravity** or **Windsurf** (user-level MCP config), run this instead:
39
+ ## Quick Start
40
+
41
+ Run from the repo you want Seer to index. Requires Node.js 24+ on Windows,
42
+ macOS, or Linux.
43
+
48
44
  ```bash
49
- npx seer-mcp init --client all
45
+ npx seer-mcp init --auto
50
46
  ```
51
47
 
52
- Reload your agent/extensions and you are connected. (Want to confirm it? Ask the agent to call `seer_health`.) The init command also writes the agent guidance files each tool reads, including `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` where applicable.
53
-
54
- Seer indexes your workspace automatically on the first query.
55
-
56
- > [!TIP]
57
- > **Optional Pre-indexing:** Avoid any first-query latency by manually pre-indexing:
58
- > ```bash
59
- > npx seer-mcp index .
60
- > ```
61
-
62
- Want user-level config? Read the [MCP Setup](docs/mcp.md) guide.
63
-
64
- → [Full Quick Start](docs/quickstart.md)
65
-
66
- ---
48
+ From another directory, pass the repo path:
49
+
50
+ ```bash
51
+ npx seer-mcp init C:\path\to\repo --auto
52
+ ```
53
+
54
+ Use this when you want Seer set up for your normal agent/editor. It writes
55
+ repo-local MCP config where possible, and detected editor-wide config for tools
56
+ like Antigravity. Editor-wide configs are pinned to this repo with
57
+ `--workspace`.
58
+
59
+ Common installs:
60
+
61
+ ```bash
62
+ npx seer-mcp init --auto # recommended
63
+ npx seer-mcp init # repo-local only, no editor-wide files
64
+ npx seer-mcp init --client antigravity # Antigravity IDE / CLI
65
+ npx seer-mcp init --client claude # Claude Code CLI
66
+ npx seer-mcp init --client codex # Codex only
67
+ npx seer-mcp init --client all # every supported client
68
+ ```
69
+
70
+ Useful flags:
71
+
72
+ - `--auto`: repo-local setup plus detected editor-wide clients.
73
+ - `--client <name>`: target one client, or use `all`.
74
+ - `--print`: preview files before writing.
75
+ - `--force`: replace an existing `seer` entry.
76
+
77
+ Restart/reload your agent, then ask it to call:
78
+
79
+ ```text
80
+ seer_health
81
+ ```
82
+
83
+ The first query builds `<repo>/.seer/graph.db`. Add `.seer/` to `.gitignore`
84
+ if it is not already ignored.
85
+
86
+ Update existing installs:
87
+
88
+ ```bash
89
+ npx seer-mcp update
90
+ ```
91
+
92
+ More detail: [Full Quick Start](docs/quickstart.md) and [MCP Setup](docs/mcp.md).
93
+
94
+ ---
67
95
 
68
96
  ## Docs
69
97