agentpack-cli 0.3.23__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.
Files changed (155) hide show
  1. agentpack_cli-0.3.24/PKG-INFO +320 -0
  2. agentpack_cli-0.3.24/README.md +273 -0
  3. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/pyproject.toml +1 -1
  4. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/__init__.py +1 -1
  5. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/dev_check.py +1 -1
  6. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/release_check.py +95 -10
  7. agentpack_cli-0.3.23/PKG-INFO +0 -547
  8. agentpack_cli-0.3.23/README.md +0 -500
  9. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/.gitignore +0 -0
  10. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/LICENSE +0 -0
  11. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/__init__.py +0 -0
  12. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/antigravity.py +0 -0
  13. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/base.py +0 -0
  14. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/claude.py +0 -0
  15. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/codex.py +0 -0
  16. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/cursor.py +0 -0
  17. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/detect.py +0 -0
  18. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/generic.py +0 -0
  19. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/adapters/windsurf.py +0 -0
  20. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/__init__.py +0 -0
  21. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/dependency_graph.py +0 -0
  22. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/go_imports.py +0 -0
  23. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/java_imports.py +0 -0
  24. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/js_ts_imports.py +0 -0
  25. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/monorepo.py +0 -0
  26. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/naming_signals.py +0 -0
  27. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/python_ast.py +0 -0
  28. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/python_imports.py +0 -0
  29. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/ranking.py +0 -0
  30. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/repo_map.py +0 -0
  31. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/role_inference.py +0 -0
  32. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/rust_imports.py +0 -0
  33. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/symbols.py +0 -0
  34. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/task_classifier.py +0 -0
  35. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/analysis/tests.py +0 -0
  36. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/application/__init__.py +0 -0
  37. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/application/pack_service.py +0 -0
  38. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/cli.py +0 -0
  39. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/__init__.py +0 -0
  40. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/_shared.py +0 -0
  41. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/benchmark.py +0 -0
  42. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/ci_cmd.py +0 -0
  43. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/claude_cmd.py +0 -0
  44. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/compress_output.py +0 -0
  45. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/dashboard.py +0 -0
  46. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/diagnose_selection.py +0 -0
  47. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/diff.py +0 -0
  48. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/doctor.py +0 -0
  49. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/eval_cmd.py +0 -0
  50. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/explain.py +0 -0
  51. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/guard.py +0 -0
  52. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/hook_cmd.py +0 -0
  53. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/ignore_cmd.py +0 -0
  54. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/init.py +0 -0
  55. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/install.py +0 -0
  56. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/learn.py +0 -0
  57. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/mcp_cmd.py +0 -0
  58. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/memory.py +0 -0
  59. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/migrate.py +0 -0
  60. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/monitor.py +0 -0
  61. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/next_cmd.py +0 -0
  62. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/pack.py +0 -0
  63. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/perf.py +0 -0
  64. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/quickstart.py +0 -0
  65. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/release_cmd.py +0 -0
  66. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/repair.py +0 -0
  67. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/retrieve.py +0 -0
  68. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/route.py +0 -0
  69. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/scan.py +0 -0
  70. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/skills.py +0 -0
  71. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/start_cmd.py +0 -0
  72. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/state_cmd.py +0 -0
  73. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/stats.py +0 -0
  74. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/status.py +0 -0
  75. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/summarize.py +0 -0
  76. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/task_cmd.py +0 -0
  77. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/threads.py +0 -0
  78. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/tune.py +0 -0
  79. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/verify_wheel.py +0 -0
  80. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/watch.py +0 -0
  81. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/workflow_cmd.py +0 -0
  82. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/commands/wrap.py +0 -0
  83. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/__init__.py +0 -0
  84. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/bootstrap.py +0 -0
  85. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/cache.py +0 -0
  86. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/changed_paths.py +0 -0
  87. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/config.py +0 -0
  88. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/context_pack.py +0 -0
  89. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/diff.py +0 -0
  90. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/evals.py +0 -0
  91. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/execution_state.py +0 -0
  92. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/git.py +0 -0
  93. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/git_hooks.py +0 -0
  94. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/global_install.py +0 -0
  95. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/ignore.py +0 -0
  96. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/loop_protocol.py +0 -0
  97. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/merkle.py +0 -0
  98. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/models.py +0 -0
  99. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/modes.py +0 -0
  100. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/pack_registry.py +0 -0
  101. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/redactor.py +0 -0
  102. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/scanner.py +0 -0
  103. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/snapshot.py +0 -0
  104. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/task_freshness.py +0 -0
  105. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/thread_context.py +0 -0
  106. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/token_estimator.py +0 -0
  107. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/core/vscode_tasks.py +0 -0
  108. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/dashboard/__init__.py +0 -0
  109. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/dashboard/collectors.py +0 -0
  110. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/dashboard/models.py +0 -0
  111. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/dashboard/renderers.py +0 -0
  112. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/data/agentpack.md +0 -0
  113. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/__init__.py +0 -0
  114. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/antigravity.py +0 -0
  115. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/claude.py +0 -0
  116. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/codex.py +0 -0
  117. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/cursor.py +0 -0
  118. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/installers/windsurf.py +0 -0
  119. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/__init__.py +0 -0
  120. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/agents.py +0 -0
  121. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/git_hooks.py +0 -0
  122. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/global_install.py +0 -0
  123. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/platform.py +0 -0
  124. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/integrations/vscode_tasks.py +0 -0
  125. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/__init__.py +0 -0
  126. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/collector.py +0 -0
  127. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/extractor.py +0 -0
  128. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/feedback.py +0 -0
  129. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/lesson_ranker.py +0 -0
  130. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/models.py +0 -0
  131. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/provider.py +0 -0
  132. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/quality.py +0 -0
  133. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/renderers.py +0 -0
  134. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/learning/skill_map.py +0 -0
  135. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/mcp_server.py +0 -0
  136. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/output_compression/__init__.py +0 -0
  137. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/output_compression/core.py +0 -0
  138. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/renderers/__init__.py +0 -0
  139. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/renderers/compact.py +0 -0
  140. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/renderers/markdown.py +0 -0
  141. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/renderers/receipts.py +0 -0
  142. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/__init__.py +0 -0
  143. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/discovery.py +0 -0
  144. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/models.py +0 -0
  145. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/parser.py +0 -0
  146. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/prompt_builder.py +0 -0
  147. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/scoring.py +0 -0
  148. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/service.py +0 -0
  149. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/router/skills_index.py +0 -0
  150. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/session/__init__.py +0 -0
  151. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/session/events.py +0 -0
  152. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/session/state.py +0 -0
  153. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/summaries/__init__.py +0 -0
  154. {agentpack_cli-0.3.23 → agentpack_cli-0.3.24}/src/agentpack/summaries/base.py +0 -0
  155. {agentpack_cli-0.3.23 → 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.23"
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"
@@ -1,3 +1,3 @@
1
1
  """AgentPack — task-aware context packing for AI coding agents."""
2
2
 
3
- __version__ = "0.3.23"
3
+ __version__ = "0.3.24"
@@ -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
  ]