@vishal2612200/agentpack 0.3.11 → 0.3.13
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/README.md +53 -8
- package/bin/agentpack.js +1 -1
- package/package.json +9 -2
package/README.md
CHANGED
|
@@ -5,20 +5,65 @@
|
|
|
5
5
|
[](https://pypi.org/project/agentpack-cli/)
|
|
6
6
|
[](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
>
|
|
10
|
-
> **Platform note:** macOS, Linux, and Windows are supported. Windows support targets PowerShell plus Git for Windows.
|
|
8
|
+
**Local MCP context router for AI coding agents.**
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
Claude Code, Codex, Cursor, and other coding agents can waste tool calls rediscovering your repo before they make the edit you asked for.
|
|
13
11
|
|
|
14
|
-
AgentPack analyzes your repo locally,
|
|
12
|
+
AgentPack analyzes your repo locally, ranks likely relevant files, tests, rules, and skills for a task, and packages compact context for Claude Code, Codex, Cursor, Windsurf, Antigravity, MCP tools and workflows, CI jobs, and other agent workflows.
|
|
15
13
|
|
|
16
|
-
Use it when the repo is too large to paste and you want
|
|
14
|
+
Use it when the repo is too large to paste and you want a repeatable context map around likely relevant routes, services, tests, configs, and recent changes.
|
|
17
15
|
|
|
18
16
|
This npm package is a launcher and wrapper for the Python CLI [`agentpack-cli`](https://pypi.org/project/agentpack-cli/), giving JavaScript-heavy teams a familiar install path while keeping the Python implementation as the source of truth.
|
|
19
17
|
|
|
20
18
|
AgentPack is a context preparation tool, not a coding agent. It stays local, deterministic, and explainable: no hosted LLM calls, no embeddings, and no vector database for scan, summarize, rank, pack, stats, or benchmark.
|
|
21
19
|
|
|
20
|
+
Try the read-only task router without writing context files:
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npx @vishal2612200/agentpack route --task "fix auth token expiry"
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
> **Status: alpha (v0.3.13).** Works, tested, and used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Current benchmarks are useful regression checks, not broad proof that AgentPack improves coding-agent success. API may change before 1.0.
|
|
29
|
+
>
|
|
30
|
+
> **Platform note:** macOS, Linux, and Windows are supported. Windows support targets PowerShell plus Git for Windows.
|
|
31
|
+
>
|
|
32
|
+
> **Name note:** PyPI package is `agentpack-cli`, npm package is `@vishal2612200/agentpack`, and the command is `agentpack`. This project is unrelated to AgentPack dataset papers or other repos with the same name.
|
|
33
|
+
|
|
34
|
+
## Before vs After
|
|
35
|
+
|
|
36
|
+
Without AgentPack, a cold coding-agent session often starts with manual repo orientation:
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
Task: fix auth token expiry
|
|
40
|
+
|
|
41
|
+
Agent:
|
|
42
|
+
- searches for auth files
|
|
43
|
+
- opens nearby middleware and config
|
|
44
|
+
- may miss related tests
|
|
45
|
+
- spends early turns building a repo map
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
With AgentPack:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
agentpack route --task "fix auth token expiry"
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
Task:
|
|
56
|
+
fix auth token expiry
|
|
57
|
+
|
|
58
|
+
Relevant files:
|
|
59
|
+
- tests/test_auth.py
|
|
60
|
+
- src/app/auth.py
|
|
61
|
+
- src/app/users.py
|
|
62
|
+
|
|
63
|
+
Suggested commands:
|
|
64
|
+
- pytest tests/test_auth.py -q
|
|
65
|
+
```
|
|
66
|
+
|
|
22
67
|
## Features
|
|
23
68
|
|
|
24
69
|
- **Task-focused packing**: ranks files from git changes, task terms, symbols, imports, related tests, configs, churn, repo history, and deterministic offline summaries.
|
|
@@ -103,11 +148,11 @@ AgentPack is not:
|
|
|
103
148
|
|
|
104
149
|
## Quality bar
|
|
105
150
|
|
|
106
|
-
AgentPack is best treated as a ranked starting map. It
|
|
151
|
+
AgentPack is best treated as a ranked starting map. It can reduce repeated orientation work, but the agent and reviewer still own correctness.
|
|
107
152
|
|
|
108
153
|
| Signal | What good looks like |
|
|
109
154
|
|---|---|
|
|
110
|
-
| Token reduction |
|
|
155
|
+
| Token reduction | Measure against raw repo text for your repo; savings depend on task, ignores, and budget |
|
|
111
156
|
| Pack size | Usually 8k-25k tokens for a specific task |
|
|
112
157
|
| Pack time | Seconds on a warm cache; first summarize pass is slower |
|
|
113
158
|
| Recall | Expected files appear near the top; validate with `agentpack benchmark --misses` |
|
package/bin/agentpack.js
CHANGED
|
@@ -6,7 +6,7 @@ const fs = require("node:fs");
|
|
|
6
6
|
const os = require("node:os");
|
|
7
7
|
const path = require("node:path");
|
|
8
8
|
|
|
9
|
-
const PACKAGE_VERSION = "0.3.
|
|
9
|
+
const PACKAGE_VERSION = "0.3.13";
|
|
10
10
|
const PYPI_PACKAGE = `agentpack-cli==${PACKAGE_VERSION}`;
|
|
11
11
|
|
|
12
12
|
function compareVersions(left, right) {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vishal2612200/agentpack",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "npm launcher for
|
|
3
|
+
"version": "0.3.13",
|
|
4
|
+
"description": "npm launcher for AgentPack, a local MCP context router for Claude Code, Codex, Cursor, and AI coding agents.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://github.com/vishal2612200/agentpack#readme",
|
|
7
7
|
"repository": {
|
|
@@ -29,11 +29,18 @@
|
|
|
29
29
|
},
|
|
30
30
|
"keywords": [
|
|
31
31
|
"ai-coding-agents",
|
|
32
|
+
"coding-agent",
|
|
33
|
+
"ai-agent",
|
|
34
|
+
"claude-code",
|
|
32
35
|
"developer-tools",
|
|
33
36
|
"repo-analysis",
|
|
37
|
+
"repo-context",
|
|
34
38
|
"context-engine",
|
|
39
|
+
"mcp-context-engine",
|
|
40
|
+
"context-router",
|
|
35
41
|
"context-packing",
|
|
36
42
|
"prompt-context",
|
|
43
|
+
"reduce-token-usage",
|
|
37
44
|
"mcp",
|
|
38
45
|
"ci",
|
|
39
46
|
"codex",
|