agentpack-cli 0.3.22__tar.gz → 0.3.24__tar.gz
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.
- agentpack_cli-0.3.24/PKG-INFO +320 -0
- agentpack_cli-0.3.24/README.md +273 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/pyproject.toml +1 -1
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/__init__.py +1 -1
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/ci_cmd.py +10 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/dev_check.py +1 -1
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/release_check.py +95 -10
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/workflow_cmd.py +215 -8
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/config.py +5 -0
- agentpack_cli-0.3.24/src/agentpack/core/loop_protocol.py +873 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/dashboard/collectors.py +23 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/dashboard/models.py +11 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/dashboard/renderers.py +8 -2
- agentpack_cli-0.3.22/PKG-INFO +0 -546
- agentpack_cli-0.3.22/README.md +0 -499
- agentpack_cli-0.3.22/src/agentpack/core/loop_protocol.py +0 -349
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/.gitignore +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/LICENSE +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/antigravity.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/base.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/claude.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/codex.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/cursor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/detect.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/generic.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/adapters/windsurf.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/dependency_graph.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/go_imports.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/java_imports.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/js_ts_imports.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/monorepo.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/naming_signals.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/python_ast.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/python_imports.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/ranking.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/repo_map.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/role_inference.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/rust_imports.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/symbols.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/task_classifier.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/analysis/tests.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/application/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/application/pack_service.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/cli.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/_shared.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/benchmark.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/claude_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/compress_output.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/dashboard.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/diagnose_selection.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/diff.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/doctor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/eval_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/explain.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/guard.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/hook_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/ignore_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/init.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/install.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/learn.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/mcp_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/memory.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/migrate.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/monitor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/next_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/pack.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/perf.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/quickstart.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/release_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/repair.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/retrieve.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/route.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/scan.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/skills.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/start_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/state_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/stats.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/status.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/summarize.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/task_cmd.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/threads.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/tune.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/verify_wheel.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/watch.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/commands/wrap.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/bootstrap.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/cache.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/changed_paths.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/context_pack.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/diff.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/evals.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/execution_state.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/git.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/git_hooks.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/global_install.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/ignore.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/merkle.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/models.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/modes.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/pack_registry.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/redactor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/scanner.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/snapshot.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/task_freshness.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/thread_context.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/token_estimator.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/core/vscode_tasks.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/dashboard/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/data/agentpack.md +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/antigravity.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/claude.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/codex.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/cursor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/installers/windsurf.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/agents.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/git_hooks.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/global_install.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/platform.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/integrations/vscode_tasks.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/collector.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/extractor.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/feedback.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/lesson_ranker.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/models.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/provider.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/quality.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/renderers.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/learning/skill_map.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/mcp_server.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/output_compression/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/output_compression/core.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/renderers/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/renderers/compact.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/renderers/markdown.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/renderers/receipts.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/discovery.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/models.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/parser.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/prompt_builder.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/scoring.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/service.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/router/skills_index.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/session/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/session/events.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/session/state.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/summaries/__init__.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/summaries/base.py +0 -0
- {agentpack_cli-0.3.22 → agentpack_cli-0.3.24}/src/agentpack/summaries/offline.py +0 -0
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: agentpack-cli
|
|
3
|
+
Version: 0.3.24
|
|
4
|
+
Summary: Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows.
|
|
5
|
+
Project-URL: Homepage, https://github.com/vishal2612200/agentpack
|
|
6
|
+
Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
|
|
7
|
+
Project-URL: Repository, https://github.com/vishal2612200/agentpack
|
|
8
|
+
Project-URL: Issues, https://github.com/vishal2612200/agentpack/issues
|
|
9
|
+
Project-URL: Changelog, https://github.com/vishal2612200/agentpack/blob/main/CHANGELOG.md
|
|
10
|
+
License: MIT
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Keywords: ai,ai-agent,ai-coding-agents,antigravity,ci,claude-code,codex,coding-agent,context,context-engine,context-packing,context-router,cursor,developer-tools,llm,local-first,mcp,mcp-context-engine,packing,prompt-context,reduce-token-usage,repo-analysis,repo-context,repo-map,task-focused-context,windsurf
|
|
13
|
+
Classifier: Development Status :: 3 - Alpha
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
21
|
+
Classifier: Topic :: Software Development :: Build Tools
|
|
22
|
+
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Requires-Dist: pathspec>=0.12.1
|
|
25
|
+
Requires-Dist: pydantic>=2.0.0
|
|
26
|
+
Requires-Dist: rich>=13.0.0
|
|
27
|
+
Requires-Dist: tiktoken>=0.7.0
|
|
28
|
+
Requires-Dist: tomli-w>=1.0.0
|
|
29
|
+
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
|
|
30
|
+
Requires-Dist: typer>=0.12.0
|
|
31
|
+
Requires-Dist: watchdog>=4.0.0
|
|
32
|
+
Provides-Extra: all
|
|
33
|
+
Requires-Dist: mcp>=1.0.0; extra == 'all'
|
|
34
|
+
Requires-Dist: watchdog>=4.0.0; extra == 'all'
|
|
35
|
+
Provides-Extra: dev
|
|
36
|
+
Requires-Dist: mypy; extra == 'dev'
|
|
37
|
+
Requires-Dist: pytest; extra == 'dev'
|
|
38
|
+
Requires-Dist: pytest-asyncio; extra == 'dev'
|
|
39
|
+
Requires-Dist: pytest-cov; extra == 'dev'
|
|
40
|
+
Requires-Dist: ruff; extra == 'dev'
|
|
41
|
+
Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
|
|
42
|
+
Provides-Extra: mcp
|
|
43
|
+
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
|
|
44
|
+
Provides-Extra: watch
|
|
45
|
+
Requires-Dist: watchdog>=4.0.0; extra == 'watch'
|
|
46
|
+
Description-Content-Type: text/markdown
|
|
47
|
+
|
|
48
|
+
# AgentPack
|
|
49
|
+
|
|
50
|
+
<p align="center">
|
|
51
|
+
<img src="docs/assets/agentpack-symbol.png" alt="AgentPack symbol: a compact map pack for coding agents" width="180">
|
|
52
|
+
</p>
|
|
53
|
+
|
|
54
|
+
<p align="center">
|
|
55
|
+
<strong>Your agent starts cold. AgentPack hands it the map.</strong>
|
|
56
|
+
</p>
|
|
57
|
+
|
|
58
|
+
<p align="center">
|
|
59
|
+
<em>Ranked repo context for Codex, Claude Code, Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, MCP, CI, and markdown workflows.</em>
|
|
60
|
+
</p>
|
|
61
|
+
|
|
62
|
+
<p align="center">
|
|
63
|
+
<a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
|
|
64
|
+
<a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
|
|
65
|
+
<a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
|
|
66
|
+
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
|
|
67
|
+
</p>
|
|
68
|
+
|
|
69
|
+
<p align="center">
|
|
70
|
+
<code>local preflight</code>
|
|
71
|
+
<code>ranked files</code>
|
|
72
|
+
<code>tests + commands</code>
|
|
73
|
+
<code>receipts</code>
|
|
74
|
+
<code>no cloud index</code>
|
|
75
|
+
</p>
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
You know the pattern. You ask an agent to fix one bug. It `rg`s half the repo, opens the wrong files, misses the test, then rediscovers the architecture you already had.
|
|
80
|
+
|
|
81
|
+
AgentPack does the repo-orientation pass first.
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
agentpack route --task "fix auth token expiry"
|
|
85
|
+
-> files that probably matter
|
|
86
|
+
-> tests that probably prove it
|
|
87
|
+
-> rules, commands, warnings
|
|
88
|
+
-> compact context before the agent edits
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
AgentPack is not another coding agent. It is the local context engine you put in front of the agents you already use.
|
|
92
|
+
|
|
93
|
+
## The Pitch
|
|
94
|
+
|
|
95
|
+
```text
|
|
96
|
+
Without AgentPack: agent explores first, edits later.
|
|
97
|
+
With AgentPack: agent starts near the right files.
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
No cloud index. No embeddings. No model calls for scan/rank/pack. Just local repo analysis, ranked context, and receipts for what got included or skipped.
|
|
101
|
+
|
|
102
|
+
It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
|
|
103
|
+
|
|
104
|
+
It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
|
|
105
|
+
|
|
106
|
+
## Quick Start
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
pipx install agentpack-cli
|
|
110
|
+
agentpack --version
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Inside your repo:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
agentpack init --yes
|
|
117
|
+
agentpack route --task "fix auth token expiry"
|
|
118
|
+
agentpack task set "fix auth token expiry"
|
|
119
|
+
agentpack pack --task auto
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
|
|
123
|
+
|
|
124
|
+
For one-shot use without installing:
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
pipx run --spec agentpack-cli agentpack route --task "fix auth token expiry"
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
For JavaScript/TypeScript projects, npm wrapper is available:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
npx @vishal2612200/agentpack --version
|
|
134
|
+
npx @vishal2612200/agentpack init --yes
|
|
135
|
+
npx @vishal2612200/agentpack task set "fix auth token expiry"
|
|
136
|
+
npx @vishal2612200/agentpack pack --task auto
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## Quick Demo
|
|
140
|
+
|
|
141
|
+
Route task first:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
agentpack route --task "fix billing webhook retry handling"
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
|
|
148
|
+
|
|
149
|
+
Build context pack next:
|
|
150
|
+
|
|
151
|
+
```bash
|
|
152
|
+
agentpack task set "fix billing webhook retry handling"
|
|
153
|
+
agentpack pack --task auto
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
|
|
157
|
+
|
|
158
|
+
## What AgentPack Gives Your Agent
|
|
159
|
+
|
|
160
|
+
- ranked files for current task
|
|
161
|
+
- likely tests and commands
|
|
162
|
+
- repo rules and agent instructions
|
|
163
|
+
- compact context pack under budget
|
|
164
|
+
- omitted-file receipts for review
|
|
165
|
+
- freshness warnings when task or git state changes
|
|
166
|
+
- local benchmark data when selected context misses real changed files
|
|
167
|
+
|
|
168
|
+
## Proof So Far
|
|
169
|
+
|
|
170
|
+
AgentPack's current public benchmark checks one narrow thing: whether selected context overlaps with files actually changed in historical commits.
|
|
171
|
+
|
|
172
|
+
Current scoped result:
|
|
173
|
+
|
|
174
|
+
| Signal | Result | Developer meaning |
|
|
175
|
+
|---|---:|---|
|
|
176
|
+
| Public commit cases | 108 | real historical file-selection checks |
|
|
177
|
+
| Average recall | 66.0% | did AgentPack include files that mattered? |
|
|
178
|
+
| Token precision | 51.1% | how much of pack was useful instead of noise? |
|
|
179
|
+
| Pack p50 | 315 tokens | typical compact starting context |
|
|
180
|
+
| Pack p95 | 1,137 tokens | larger but still bounded starting context |
|
|
181
|
+
|
|
182
|
+
Source: [`benchmarks/results/2026-06-14-public.md`](benchmarks/results/2026-06-14-public.md). Benchmark guide: [`docs/benchmarking.md`](docs/benchmarking.md).
|
|
183
|
+
|
|
184
|
+
This is useful but not magic. It says AgentPack often gets meaningful files into a small pack. It does not claim every agent finishes faster or writes better code. Agent success A/B benchmarks should report task success, tool calls, token cost, and time-to-first-correct-file.
|
|
185
|
+
|
|
186
|
+
## What We Want To Prove Next
|
|
187
|
+
|
|
188
|
+
AgentPack should eventually show:
|
|
189
|
+
|
|
190
|
+
- fewer agent file reads
|
|
191
|
+
- fewer tool calls
|
|
192
|
+
- faster first correct file
|
|
193
|
+
- lower total context cost
|
|
194
|
+
- equal or better task success
|
|
195
|
+
|
|
196
|
+
## Works With
|
|
197
|
+
|
|
198
|
+
- Codex
|
|
199
|
+
- Claude Code
|
|
200
|
+
- Cursor
|
|
201
|
+
- Windsurf
|
|
202
|
+
- Antigravity
|
|
203
|
+
- MCP tools
|
|
204
|
+
- CI and PR review workflows
|
|
205
|
+
- generic markdown-based LLM workflows
|
|
206
|
+
|
|
207
|
+
See [`docs/integrations.md`](docs/integrations.md) and [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md).
|
|
208
|
+
|
|
209
|
+
### Agent And IDE Plugins
|
|
210
|
+
|
|
211
|
+
AgentPack can be used through thin plugin and IDE integration layers so agents start with ranked repo context. Codex has a packaged plugin skeleton; Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, Claude Code, Antigravity, and generic agents use the same local CLI/MCP engine through portable rules, hooks, and native integration stubs.
|
|
212
|
+
|
|
213
|
+
Inside Codex:
|
|
214
|
+
|
|
215
|
+
```text
|
|
216
|
+
@agentpack-route fix auth token expiry
|
|
217
|
+
@agentpack-pack fix auth token expiry
|
|
218
|
+
@agentpack-review
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
The plugin calls the local AgentPack engine. It does not upload code and does not turn AgentPack into a coding agent.
|
|
222
|
+
|
|
223
|
+
See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`](docs/codex-plugin.md).
|
|
224
|
+
|
|
225
|
+
## How AgentPack Compares
|
|
226
|
+
|
|
227
|
+
| Tool type | What it does | AgentPack difference |
|
|
228
|
+
|---|---|---|
|
|
229
|
+
| Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
|
|
230
|
+
| Coding agents | Edit code | AgentPack prepares context before editing |
|
|
231
|
+
| IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
|
|
232
|
+
| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
|
|
233
|
+
|
|
234
|
+
## When To Use It
|
|
235
|
+
|
|
236
|
+
Use AgentPack when:
|
|
237
|
+
|
|
238
|
+
- repo is large or split across multiple packages
|
|
239
|
+
- monorepo structure makes file discovery expensive
|
|
240
|
+
- agents repeat same discovery work across tasks
|
|
241
|
+
- CI or PR review needs reproducible context
|
|
242
|
+
- agents waste tool calls opening irrelevant files
|
|
243
|
+
- tasks often miss tests, config, generated rules, or repo conventions
|
|
244
|
+
|
|
245
|
+
Do not use AgentPack when:
|
|
246
|
+
|
|
247
|
+
- repo is tiny
|
|
248
|
+
- question is one-shot and read-only
|
|
249
|
+
- you already know exact files to edit
|
|
250
|
+
- you need autonomous coding, not context preparation
|
|
251
|
+
- native IDE search is already enough for task
|
|
252
|
+
|
|
253
|
+
## How It Works
|
|
254
|
+
|
|
255
|
+
AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
|
|
256
|
+
|
|
257
|
+
It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
|
|
258
|
+
|
|
259
|
+
Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
|
|
260
|
+
|
|
261
|
+
## Trust And Privacy
|
|
262
|
+
|
|
263
|
+
- local-first by default
|
|
264
|
+
- no cloud indexing
|
|
265
|
+
- no embeddings or API calls for scan, rank, pack, stats, or benchmark
|
|
266
|
+
- generated files live under `.agentpack/`
|
|
267
|
+
- review packs before sharing them outside your machine
|
|
268
|
+
|
|
269
|
+
Details: [`docs/privacy.md`](docs/privacy.md), [`docs/threat-model.md`](docs/threat-model.md), [`docs/data-flow.md`](docs/data-flow.md), and [`SECURITY.md`](SECURITY.md).
|
|
270
|
+
|
|
271
|
+
## Install Notes
|
|
272
|
+
|
|
273
|
+
Requires Python 3.10+ and is tested on Python 3.10-3.14. PyPI package is `agentpack-cli`; command is `agentpack`.
|
|
274
|
+
|
|
275
|
+
Use `pipx` for normal installs because many macOS/Linux Python distributions block global `pip install` with PEP 668's `externally-managed-environment` error.
|
|
276
|
+
|
|
277
|
+
Install `pipx` first if needed:
|
|
278
|
+
|
|
279
|
+
```bash
|
|
280
|
+
# macOS
|
|
281
|
+
brew install pipx
|
|
282
|
+
|
|
283
|
+
# Ubuntu/Debian
|
|
284
|
+
sudo apt install pipx
|
|
285
|
+
|
|
286
|
+
# Fedora
|
|
287
|
+
sudo dnf install pipx
|
|
288
|
+
|
|
289
|
+
# Arch
|
|
290
|
+
sudo pacman -S python-pipx
|
|
291
|
+
|
|
292
|
+
pipx ensurepath
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
## Docs
|
|
296
|
+
|
|
297
|
+
- [`docs/index.md`](docs/index.md): docs home
|
|
298
|
+
- [`docs/architecture.md`](docs/architecture.md): pipeline, data flow, package layout, and rendered-budget accounting
|
|
299
|
+
- [`docs/commands.md`](docs/commands.md): full CLI command reference
|
|
300
|
+
- [`docs/configuration.md`](docs/configuration.md): config, scoring weights, `.agentignore`, and git integration
|
|
301
|
+
- [`docs/integrations.md`](docs/integrations.md): agent setup, MCP workflow, hooks, and native integration status
|
|
302
|
+
- [`docs/agent-plugins.md`](docs/agent-plugins.md): plugin and IDE distribution layer
|
|
303
|
+
- [`docs/codex-plugin.md`](docs/codex-plugin.md): thin Codex plugin commands and local workflow
|
|
304
|
+
- [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md): MCP tools and context workflow
|
|
305
|
+
- [`docs/benchmarking.md`](docs/benchmarking.md): quality bar, release gate, and public artifacts
|
|
306
|
+
- [`docs/limitations.md`](docs/limitations.md): project scope, known limits, and roadmap
|
|
307
|
+
|
|
308
|
+
## Status
|
|
309
|
+
|
|
310
|
+
Alpha: `0.3.24`.
|
|
311
|
+
|
|
312
|
+
Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
|
|
313
|
+
|
|
314
|
+
Platform support targets macOS, Linux, and Windows PowerShell with Git for Windows. `cmd.exe` and bare Git setups are not supported yet.
|
|
315
|
+
|
|
316
|
+
Name note: PyPI package is `agentpack-cli`, npm package is `@vishal2612200/agentpack`, and command is `agentpack`. This project is unrelated to AgentPack dataset papers or other repos with the same name.
|
|
317
|
+
|
|
318
|
+
## License
|
|
319
|
+
|
|
320
|
+
MIT
|
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
# AgentPack
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="docs/assets/agentpack-symbol.png" alt="AgentPack symbol: a compact map pack for coding agents" width="180">
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<strong>Your agent starts cold. AgentPack hands it the map.</strong>
|
|
9
|
+
</p>
|
|
10
|
+
|
|
11
|
+
<p align="center">
|
|
12
|
+
<em>Ranked repo context for Codex, Claude Code, Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, MCP, CI, and markdown workflows.</em>
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
|
|
17
|
+
<a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
|
|
18
|
+
<a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
|
|
19
|
+
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
|
|
20
|
+
</p>
|
|
21
|
+
|
|
22
|
+
<p align="center">
|
|
23
|
+
<code>local preflight</code>
|
|
24
|
+
<code>ranked files</code>
|
|
25
|
+
<code>tests + commands</code>
|
|
26
|
+
<code>receipts</code>
|
|
27
|
+
<code>no cloud index</code>
|
|
28
|
+
</p>
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
You know the pattern. You ask an agent to fix one bug. It `rg`s half the repo, opens the wrong files, misses the test, then rediscovers the architecture you already had.
|
|
33
|
+
|
|
34
|
+
AgentPack does the repo-orientation pass first.
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
agentpack route --task "fix auth token expiry"
|
|
38
|
+
-> files that probably matter
|
|
39
|
+
-> tests that probably prove it
|
|
40
|
+
-> rules, commands, warnings
|
|
41
|
+
-> compact context before the agent edits
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
AgentPack is not another coding agent. It is the local context engine you put in front of the agents you already use.
|
|
45
|
+
|
|
46
|
+
## The Pitch
|
|
47
|
+
|
|
48
|
+
```text
|
|
49
|
+
Without AgentPack: agent explores first, edits later.
|
|
50
|
+
With AgentPack: agent starts near the right files.
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
No cloud index. No embeddings. No model calls for scan/rank/pack. Just local repo analysis, ranked context, and receipts for what got included or skipped.
|
|
54
|
+
|
|
55
|
+
It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
|
|
56
|
+
|
|
57
|
+
It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
|
|
58
|
+
|
|
59
|
+
## Quick Start
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
pipx install agentpack-cli
|
|
63
|
+
agentpack --version
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Inside your repo:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
agentpack init --yes
|
|
70
|
+
agentpack route --task "fix auth token expiry"
|
|
71
|
+
agentpack task set "fix auth token expiry"
|
|
72
|
+
agentpack pack --task auto
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
|
|
76
|
+
|
|
77
|
+
For one-shot use without installing:
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
pipx run --spec agentpack-cli agentpack route --task "fix auth token expiry"
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
For JavaScript/TypeScript projects, npm wrapper is available:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
npx @vishal2612200/agentpack --version
|
|
87
|
+
npx @vishal2612200/agentpack init --yes
|
|
88
|
+
npx @vishal2612200/agentpack task set "fix auth token expiry"
|
|
89
|
+
npx @vishal2612200/agentpack pack --task auto
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Quick Demo
|
|
93
|
+
|
|
94
|
+
Route task first:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
agentpack route --task "fix billing webhook retry handling"
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
|
|
101
|
+
|
|
102
|
+
Build context pack next:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
agentpack task set "fix billing webhook retry handling"
|
|
106
|
+
agentpack pack --task auto
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
|
|
110
|
+
|
|
111
|
+
## What AgentPack Gives Your Agent
|
|
112
|
+
|
|
113
|
+
- ranked files for current task
|
|
114
|
+
- likely tests and commands
|
|
115
|
+
- repo rules and agent instructions
|
|
116
|
+
- compact context pack under budget
|
|
117
|
+
- omitted-file receipts for review
|
|
118
|
+
- freshness warnings when task or git state changes
|
|
119
|
+
- local benchmark data when selected context misses real changed files
|
|
120
|
+
|
|
121
|
+
## Proof So Far
|
|
122
|
+
|
|
123
|
+
AgentPack's current public benchmark checks one narrow thing: whether selected context overlaps with files actually changed in historical commits.
|
|
124
|
+
|
|
125
|
+
Current scoped result:
|
|
126
|
+
|
|
127
|
+
| Signal | Result | Developer meaning |
|
|
128
|
+
|---|---:|---|
|
|
129
|
+
| Public commit cases | 108 | real historical file-selection checks |
|
|
130
|
+
| Average recall | 66.0% | did AgentPack include files that mattered? |
|
|
131
|
+
| Token precision | 51.1% | how much of pack was useful instead of noise? |
|
|
132
|
+
| Pack p50 | 315 tokens | typical compact starting context |
|
|
133
|
+
| Pack p95 | 1,137 tokens | larger but still bounded starting context |
|
|
134
|
+
|
|
135
|
+
Source: [`benchmarks/results/2026-06-14-public.md`](benchmarks/results/2026-06-14-public.md). Benchmark guide: [`docs/benchmarking.md`](docs/benchmarking.md).
|
|
136
|
+
|
|
137
|
+
This is useful but not magic. It says AgentPack often gets meaningful files into a small pack. It does not claim every agent finishes faster or writes better code. Agent success A/B benchmarks should report task success, tool calls, token cost, and time-to-first-correct-file.
|
|
138
|
+
|
|
139
|
+
## What We Want To Prove Next
|
|
140
|
+
|
|
141
|
+
AgentPack should eventually show:
|
|
142
|
+
|
|
143
|
+
- fewer agent file reads
|
|
144
|
+
- fewer tool calls
|
|
145
|
+
- faster first correct file
|
|
146
|
+
- lower total context cost
|
|
147
|
+
- equal or better task success
|
|
148
|
+
|
|
149
|
+
## Works With
|
|
150
|
+
|
|
151
|
+
- Codex
|
|
152
|
+
- Claude Code
|
|
153
|
+
- Cursor
|
|
154
|
+
- Windsurf
|
|
155
|
+
- Antigravity
|
|
156
|
+
- MCP tools
|
|
157
|
+
- CI and PR review workflows
|
|
158
|
+
- generic markdown-based LLM workflows
|
|
159
|
+
|
|
160
|
+
See [`docs/integrations.md`](docs/integrations.md) and [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md).
|
|
161
|
+
|
|
162
|
+
### Agent And IDE Plugins
|
|
163
|
+
|
|
164
|
+
AgentPack can be used through thin plugin and IDE integration layers so agents start with ranked repo context. Codex has a packaged plugin skeleton; Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, Claude Code, Antigravity, and generic agents use the same local CLI/MCP engine through portable rules, hooks, and native integration stubs.
|
|
165
|
+
|
|
166
|
+
Inside Codex:
|
|
167
|
+
|
|
168
|
+
```text
|
|
169
|
+
@agentpack-route fix auth token expiry
|
|
170
|
+
@agentpack-pack fix auth token expiry
|
|
171
|
+
@agentpack-review
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
The plugin calls the local AgentPack engine. It does not upload code and does not turn AgentPack into a coding agent.
|
|
175
|
+
|
|
176
|
+
See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`](docs/codex-plugin.md).
|
|
177
|
+
|
|
178
|
+
## How AgentPack Compares
|
|
179
|
+
|
|
180
|
+
| Tool type | What it does | AgentPack difference |
|
|
181
|
+
|---|---|---|
|
|
182
|
+
| Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
|
|
183
|
+
| Coding agents | Edit code | AgentPack prepares context before editing |
|
|
184
|
+
| IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
|
|
185
|
+
| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
|
|
186
|
+
|
|
187
|
+
## When To Use It
|
|
188
|
+
|
|
189
|
+
Use AgentPack when:
|
|
190
|
+
|
|
191
|
+
- repo is large or split across multiple packages
|
|
192
|
+
- monorepo structure makes file discovery expensive
|
|
193
|
+
- agents repeat same discovery work across tasks
|
|
194
|
+
- CI or PR review needs reproducible context
|
|
195
|
+
- agents waste tool calls opening irrelevant files
|
|
196
|
+
- tasks often miss tests, config, generated rules, or repo conventions
|
|
197
|
+
|
|
198
|
+
Do not use AgentPack when:
|
|
199
|
+
|
|
200
|
+
- repo is tiny
|
|
201
|
+
- question is one-shot and read-only
|
|
202
|
+
- you already know exact files to edit
|
|
203
|
+
- you need autonomous coding, not context preparation
|
|
204
|
+
- native IDE search is already enough for task
|
|
205
|
+
|
|
206
|
+
## How It Works
|
|
207
|
+
|
|
208
|
+
AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
|
|
209
|
+
|
|
210
|
+
It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
|
|
211
|
+
|
|
212
|
+
Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
|
|
213
|
+
|
|
214
|
+
## Trust And Privacy
|
|
215
|
+
|
|
216
|
+
- local-first by default
|
|
217
|
+
- no cloud indexing
|
|
218
|
+
- no embeddings or API calls for scan, rank, pack, stats, or benchmark
|
|
219
|
+
- generated files live under `.agentpack/`
|
|
220
|
+
- review packs before sharing them outside your machine
|
|
221
|
+
|
|
222
|
+
Details: [`docs/privacy.md`](docs/privacy.md), [`docs/threat-model.md`](docs/threat-model.md), [`docs/data-flow.md`](docs/data-flow.md), and [`SECURITY.md`](SECURITY.md).
|
|
223
|
+
|
|
224
|
+
## Install Notes
|
|
225
|
+
|
|
226
|
+
Requires Python 3.10+ and is tested on Python 3.10-3.14. PyPI package is `agentpack-cli`; command is `agentpack`.
|
|
227
|
+
|
|
228
|
+
Use `pipx` for normal installs because many macOS/Linux Python distributions block global `pip install` with PEP 668's `externally-managed-environment` error.
|
|
229
|
+
|
|
230
|
+
Install `pipx` first if needed:
|
|
231
|
+
|
|
232
|
+
```bash
|
|
233
|
+
# macOS
|
|
234
|
+
brew install pipx
|
|
235
|
+
|
|
236
|
+
# Ubuntu/Debian
|
|
237
|
+
sudo apt install pipx
|
|
238
|
+
|
|
239
|
+
# Fedora
|
|
240
|
+
sudo dnf install pipx
|
|
241
|
+
|
|
242
|
+
# Arch
|
|
243
|
+
sudo pacman -S python-pipx
|
|
244
|
+
|
|
245
|
+
pipx ensurepath
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
## Docs
|
|
249
|
+
|
|
250
|
+
- [`docs/index.md`](docs/index.md): docs home
|
|
251
|
+
- [`docs/architecture.md`](docs/architecture.md): pipeline, data flow, package layout, and rendered-budget accounting
|
|
252
|
+
- [`docs/commands.md`](docs/commands.md): full CLI command reference
|
|
253
|
+
- [`docs/configuration.md`](docs/configuration.md): config, scoring weights, `.agentignore`, and git integration
|
|
254
|
+
- [`docs/integrations.md`](docs/integrations.md): agent setup, MCP workflow, hooks, and native integration status
|
|
255
|
+
- [`docs/agent-plugins.md`](docs/agent-plugins.md): plugin and IDE distribution layer
|
|
256
|
+
- [`docs/codex-plugin.md`](docs/codex-plugin.md): thin Codex plugin commands and local workflow
|
|
257
|
+
- [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md): MCP tools and context workflow
|
|
258
|
+
- [`docs/benchmarking.md`](docs/benchmarking.md): quality bar, release gate, and public artifacts
|
|
259
|
+
- [`docs/limitations.md`](docs/limitations.md): project scope, known limits, and roadmap
|
|
260
|
+
|
|
261
|
+
## Status
|
|
262
|
+
|
|
263
|
+
Alpha: `0.3.24`.
|
|
264
|
+
|
|
265
|
+
Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
|
|
266
|
+
|
|
267
|
+
Platform support targets macOS, Linux, and Windows PowerShell with Git for Windows. `cmd.exe` and bare Git setups are not supported yet.
|
|
268
|
+
|
|
269
|
+
Name note: PyPI package is `agentpack-cli`, npm package is `@vishal2612200/agentpack`, and command is `agentpack`. This project is unrelated to AgentPack dataset papers or other repos with the same name.
|
|
270
|
+
|
|
271
|
+
## License
|
|
272
|
+
|
|
273
|
+
MIT
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "agentpack-cli"
|
|
3
|
-
version = "0.3.
|
|
3
|
+
version = "0.3.24"
|
|
4
4
|
description = "Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows."
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
requires-python = ">=3.10"
|
|
@@ -64,6 +64,16 @@ jobs:
|
|
|
64
64
|
- run: python -m pip install -e ".[dev]"
|
|
65
65
|
- run: python -m agentpack.cli dev-check
|
|
66
66
|
|
|
67
|
+
loop-smoke:
|
|
68
|
+
runs-on: ubuntu-latest
|
|
69
|
+
steps:
|
|
70
|
+
- uses: actions/checkout@v4
|
|
71
|
+
- uses: actions/setup-python@v5
|
|
72
|
+
with:
|
|
73
|
+
python-version: "3.11"
|
|
74
|
+
- run: python -m pip install -e ".[dev]"
|
|
75
|
+
- run: python -m agentpack.cli loop-smoke --json
|
|
76
|
+
|
|
67
77
|
release-gate:
|
|
68
78
|
runs-on: ubuntu-latest
|
|
69
79
|
if: github.event_name == 'push'
|
|
@@ -27,7 +27,7 @@ def register(app: typer.Typer) -> None:
|
|
|
27
27
|
stages = [
|
|
28
28
|
CheckStage("docs-check", [sys.executable, "-m", "pytest", "tests/test_docs_links.py", "-q"]),
|
|
29
29
|
CheckStage("ruff", [sys.executable, "-m", "ruff", "check", "src", "tests"]),
|
|
30
|
-
CheckStage("pytest", [sys.executable, "-m", "pytest", "-q"]),
|
|
30
|
+
CheckStage("pytest", [sys.executable, "-m", "pytest", "-q", "-m", "not slow"]),
|
|
31
31
|
CheckStage("npm-version-sync", ["node", "npm/test/version-sync.test.js"]),
|
|
32
32
|
CheckStage("npm-launcher", ["node", "npm/test/launcher.test.js"]),
|
|
33
33
|
]
|