agentpack-cli 0.3.23__tar.gz → 0.3.25__tar.gz

agentpack_cli-0.3.25/PKG-INFO

@@ -0,0 +1,334 @@
+Metadata-Version: 2.4
+Name: agentpack-cli
+Version: 0.3.25
+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.
+Project-URL: Homepage, https://github.com/vishal2612200/agentpack
+Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
+Project-URL: Repository, https://github.com/vishal2612200/agentpack
+Project-URL: Issues, https://github.com/vishal2612200/agentpack/issues
+Project-URL: Changelog, https://github.com/vishal2612200/agentpack/blob/main/CHANGELOG.md
+License: MIT
+License-File: LICENSE
+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
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: pathspec>=0.12.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tiktoken>=0.7.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Requires-Dist: watchdog>=4.0.0
+Provides-Extra: all
+Requires-Dist: mcp>=1.0.0; extra == 'all'
+Requires-Dist: watchdog>=4.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Provides-Extra: watch
+Requires-Dist: watchdog>=4.0.0; extra == 'watch'
+Description-Content-Type: text/markdown
+
+# AgentPack
+
+<p align="center">
+  <img src="docs/assets/agentpack-symbol.png" alt="AgentPack symbol: a compact map pack for coding agents" width="180">
+</p>
+
+<p align="center">
+  <strong>Your agent starts cold. AgentPack hands it the map.</strong>
+</p>
+
+<p align="center">
+  <em>Ranked repo context for Codex, Claude Code, Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, MCP, CI, and markdown workflows.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
+  <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>
+  <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
+</p>
+
+<p align="center">
+  <code>local preflight</code>
+  <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
+  <code>tests + commands</code>
+  <code>receipts</code>
+  <code>no cloud index</code>
+</p>
+
+---
+
+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.
+
+AgentPack does the repo-orientation pass first.
+
+```text
+agentpack route --task "fix auth token expiry"
+-> files that probably matter
+-> skills and rules that fit the task
+-> tests that probably prove it
+-> rules, commands, warnings
+-> compact context before the agent edits
+```
+
+AgentPack is not another coding agent. It is the local context engine you put in front of the agents you already use.
+
+## The Pitch
+
+```text
+Without AgentPack: agent explores first, edits later.
+With AgentPack:    agent starts near the right files.
+```
+
+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.
+
+It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
+
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
+
+## Quick Start
+
+```bash
+pipx install agentpack-cli
+agentpack --version
+```
+
+Inside your repo:
+
+```bash
+agentpack init --yes
+agentpack route --task "fix auth token expiry"
+agentpack task set "fix auth token expiry"
+agentpack pack --task auto
+```
+
+Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
+
+For one-shot use without installing:
+
+```bash
+pipx run --spec agentpack-cli agentpack route --task "fix auth token expiry"
+```
+
+For JavaScript/TypeScript projects, npm wrapper is available:
+
+```bash
+npx @vishal2612200/agentpack --version
+npx @vishal2612200/agentpack init --yes
+npx @vishal2612200/agentpack task set "fix auth token expiry"
+npx @vishal2612200/agentpack pack --task auto
+```
+
+## Quick Demo
+
+Route task first:
+
+```bash
+agentpack route --task "fix billing webhook retry handling"
+```
+
+AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
+
+Build context pack next:
+
+```bash
+agentpack task set "fix billing webhook retry handling"
+agentpack pack --task auto
+```
+
+AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
+
+## What AgentPack Gives Your Agent
+
+- ranked files for current task
+- skill and rule routing for current task
+- likely tests and commands
+- repo rules and agent instructions
+- compact context pack under budget
+- cached summaries for faster repeated orientation
+- omitted-file receipts for review
+- freshness warnings when task or git state changes
+- local benchmark data when selected context misses real changed files
+
+## Proof So Far
+
+AgentPack's current public benchmark checks one narrow thing: whether selected context overlaps with files actually changed in historical commits.
+
+Current scoped result:
+
+| Signal | Result | Developer meaning |
+|---|---:|---|
+| Public commit cases | 108 | real historical file-selection checks |
+| Average recall | 66.0% | did AgentPack include files that mattered? |
+| Token precision | 51.1% | how much of pack was useful instead of noise? |
+| Pack p50 | 315 tokens | typical compact starting context |
+| Pack p95 | 1,137 tokens | larger but still bounded starting context |
+
+Source: [`benchmarks/results/2026-06-14-public.md`](benchmarks/results/2026-06-14-public.md). Benchmark guide: [`docs/benchmarking.md`](docs/benchmarking.md).
+
+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.
+
+## What We Want To Prove Next
+
+AgentPack should eventually show:
+
+- fewer agent file reads
+- fewer tool calls
+- faster first correct file
+- lower total context cost
+- equal or better task success
+
+## Works With
+
+- Codex
+- Claude Code
+- Cursor
+- Windsurf
+- Antigravity
+- MCP tools
+- CI and PR review workflows
+- generic markdown-based LLM workflows
+
+See [`docs/integrations.md`](docs/integrations.md) and [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md).
+
+### Agent And IDE Plugins
+
+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.
+
+Inside Codex:
+
+```text
+@agentpack-route fix auth token expiry
+@agentpack-pack fix auth token expiry
+@agentpack-review
+```
+
+The plugin calls the local AgentPack engine. It does not upload code and does not turn AgentPack into a coding agent.
+
+See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`](docs/codex-plugin.md).
+
+## How AgentPack Compares
+
+| Tool type | What it does | AgentPack difference |
+|---|---|---|
+| Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
+| Coding agents | Edit code | AgentPack prepares context before editing |
+| IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
+
+## When To Use It
+
+Use AgentPack when:
+
+- repo is large or split across multiple packages
+- monorepo structure makes file discovery expensive
+- agents repeat same discovery work across tasks
+- CI or PR review needs reproducible context
+- agents waste tool calls opening irrelevant files
+- tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
+
+Do not use AgentPack when:
+
+- repo is tiny
+- question is one-shot and read-only
+- you already know exact files to edit
+- you need autonomous coding, not context preparation
+- native IDE search is already enough for task
+
+## How It Works
+
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
+
+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).
+
+## Trust And Privacy
+
+- local-first by default
+- no cloud indexing
+- no embeddings or API calls for scan, rank, pack, stats, or benchmark
+- generated files live under `.agentpack/`
+- review packs before sharing them outside your machine
+
+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).
+
+## Install Notes
+
+Requires Python 3.10+ and is tested on Python 3.10-3.14. PyPI package is `agentpack-cli`; command is `agentpack`.
+
+Use `pipx` for normal installs because many macOS/Linux Python distributions block global `pip install` with PEP 668's `externally-managed-environment` error.
+
+Install `pipx` first if needed:
+
+```bash
+# macOS
+brew install pipx
+
+# Ubuntu/Debian
+sudo apt install pipx
+
+# Fedora
+sudo dnf install pipx
+
+# Arch
+sudo pacman -S python-pipx
+
+pipx ensurepath
+```
+
+## Docs
+
+- [`docs/index.md`](docs/index.md): docs home
+- [`docs/architecture.md`](docs/architecture.md): pipeline, data flow, package layout, and rendered-budget accounting
+- [`docs/commands.md`](docs/commands.md): full CLI command reference
+- [`docs/configuration.md`](docs/configuration.md): config, scoring weights, `.agentignore`, and git integration
+- [`docs/integrations.md`](docs/integrations.md): agent setup, MCP workflow, hooks, and native integration status
+- [`docs/agent-plugins.md`](docs/agent-plugins.md): plugin and IDE distribution layer
+- [`docs/codex-plugin.md`](docs/codex-plugin.md): thin Codex plugin commands and local workflow
+- [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md): MCP tools and context workflow
+- [`docs/benchmarking.md`](docs/benchmarking.md): quality bar, release gate, and public artifacts
+- [`docs/limitations.md`](docs/limitations.md): project scope, known limits, and roadmap
+
+## Status
+
+Alpha: `0.3.25`.
+
+Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
+
+Platform support targets macOS, Linux, and Windows PowerShell with Git for Windows. `cmd.exe` and bare Git setups are not supported yet.
+
+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.
+
+## License
+
+MIT

agentpack_cli-0.3.25/README.md

@@ -0,0 +1,287 @@
+# AgentPack
+
+<p align="center">
+  <img src="docs/assets/agentpack-symbol.png" alt="AgentPack symbol: a compact map pack for coding agents" width="180">
+</p>
+
+<p align="center">
+  <strong>Your agent starts cold. AgentPack hands it the map.</strong>
+</p>
+
+<p align="center">
+  <em>Ranked repo context for Codex, Claude Code, Cursor, Windsurf, Copilot, Cline, Kiro, OpenCode, MCP, CI, and markdown workflows.</em>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
+  <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>
+  <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
+</p>
+
+<p align="center">
+  <code>local preflight</code>
+  <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
+  <code>tests + commands</code>
+  <code>receipts</code>
+  <code>no cloud index</code>
+</p>
+
+---
+
+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.
+
+AgentPack does the repo-orientation pass first.
+
+```text
+agentpack route --task "fix auth token expiry"
+-> files that probably matter
+-> skills and rules that fit the task
+-> tests that probably prove it
+-> rules, commands, warnings
+-> compact context before the agent edits
+```
+
+AgentPack is not another coding agent. It is the local context engine you put in front of the agents you already use.
+
+## The Pitch
+
+```text
+Without AgentPack: agent explores first, edits later.
+With AgentPack:    agent starts near the right files.
+```
+
+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.
+
+It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
+
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
+
+## Quick Start
+
+```bash
+pipx install agentpack-cli
+agentpack --version
+```
+
+Inside your repo:
+
+```bash
+agentpack init --yes
+agentpack route --task "fix auth token expiry"
+agentpack task set "fix auth token expiry"
+agentpack pack --task auto
+```
+
+Then give `.agentpack/context.md` to your agent, or let MCP-capable agents call AgentPack tools directly.
+
+For one-shot use without installing:
+
+```bash
+pipx run --spec agentpack-cli agentpack route --task "fix auth token expiry"
+```
+
+For JavaScript/TypeScript projects, npm wrapper is available:
+
+```bash
+npx @vishal2612200/agentpack --version
+npx @vishal2612200/agentpack init --yes
+npx @vishal2612200/agentpack task set "fix auth token expiry"
+npx @vishal2612200/agentpack pack --task auto
+```
+
+## Quick Demo
+
+Route task first:
+
+```bash
+agentpack route --task "fix billing webhook retry handling"
+```
+
+AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
+
+Build context pack next:
+
+```bash
+agentpack task set "fix billing webhook retry handling"
+agentpack pack --task auto
+```
+
+AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
+
+## What AgentPack Gives Your Agent
+
+- ranked files for current task
+- skill and rule routing for current task
+- likely tests and commands
+- repo rules and agent instructions
+- compact context pack under budget
+- cached summaries for faster repeated orientation
+- omitted-file receipts for review
+- freshness warnings when task or git state changes
+- local benchmark data when selected context misses real changed files
+
+## Proof So Far
+
+AgentPack's current public benchmark checks one narrow thing: whether selected context overlaps with files actually changed in historical commits.
+
+Current scoped result:
+
+| Signal | Result | Developer meaning |
+|---|---:|---|
+| Public commit cases | 108 | real historical file-selection checks |
+| Average recall | 66.0% | did AgentPack include files that mattered? |
+| Token precision | 51.1% | how much of pack was useful instead of noise? |
+| Pack p50 | 315 tokens | typical compact starting context |
+| Pack p95 | 1,137 tokens | larger but still bounded starting context |
+
+Source: [`benchmarks/results/2026-06-14-public.md`](benchmarks/results/2026-06-14-public.md). Benchmark guide: [`docs/benchmarking.md`](docs/benchmarking.md).
+
+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.
+
+## What We Want To Prove Next
+
+AgentPack should eventually show:
+
+- fewer agent file reads
+- fewer tool calls
+- faster first correct file
+- lower total context cost
+- equal or better task success
+
+## Works With
+
+- Codex
+- Claude Code
+- Cursor
+- Windsurf
+- Antigravity
+- MCP tools
+- CI and PR review workflows
+- generic markdown-based LLM workflows
+
+See [`docs/integrations.md`](docs/integrations.md) and [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md).
+
+### Agent And IDE Plugins
+
+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.
+
+Inside Codex:
+
+```text
+@agentpack-route fix auth token expiry
+@agentpack-pack fix auth token expiry
+@agentpack-review
+```
+
+The plugin calls the local AgentPack engine. It does not upload code and does not turn AgentPack into a coding agent.
+
+See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`](docs/codex-plugin.md).
+
+## How AgentPack Compares
+
+| Tool type | What it does | AgentPack difference |
+|---|---|---|
+| Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
+| Coding agents | Edit code | AgentPack prepares context before editing |
+| IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
+
+## When To Use It
+
+Use AgentPack when:
+
+- repo is large or split across multiple packages
+- monorepo structure makes file discovery expensive
+- agents repeat same discovery work across tasks
+- CI or PR review needs reproducible context
+- agents waste tool calls opening irrelevant files
+- tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
+
+Do not use AgentPack when:
+
+- repo is tiny
+- question is one-shot and read-only
+- you already know exact files to edit
+- you need autonomous coding, not context preparation
+- native IDE search is already enough for task
+
+## How It Works
+
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
+
+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).
+
+## Trust And Privacy
+
+- local-first by default
+- no cloud indexing
+- no embeddings or API calls for scan, rank, pack, stats, or benchmark
+- generated files live under `.agentpack/`
+- review packs before sharing them outside your machine
+
+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).
+
+## Install Notes
+
+Requires Python 3.10+ and is tested on Python 3.10-3.14. PyPI package is `agentpack-cli`; command is `agentpack`.
+
+Use `pipx` for normal installs because many macOS/Linux Python distributions block global `pip install` with PEP 668's `externally-managed-environment` error.
+
+Install `pipx` first if needed:
+
+```bash
+# macOS
+brew install pipx
+
+# Ubuntu/Debian
+sudo apt install pipx
+
+# Fedora
+sudo dnf install pipx
+
+# Arch
+sudo pacman -S python-pipx
+
+pipx ensurepath
+```
+
+## Docs
+
+- [`docs/index.md`](docs/index.md): docs home
+- [`docs/architecture.md`](docs/architecture.md): pipeline, data flow, package layout, and rendered-budget accounting
+- [`docs/commands.md`](docs/commands.md): full CLI command reference
+- [`docs/configuration.md`](docs/configuration.md): config, scoring weights, `.agentignore`, and git integration
+- [`docs/integrations.md`](docs/integrations.md): agent setup, MCP workflow, hooks, and native integration status
+- [`docs/agent-plugins.md`](docs/agent-plugins.md): plugin and IDE distribution layer
+- [`docs/codex-plugin.md`](docs/codex-plugin.md): thin Codex plugin commands and local workflow
+- [`docs/mcp-context-engine.md`](docs/mcp-context-engine.md): MCP tools and context workflow
+- [`docs/benchmarking.md`](docs/benchmarking.md): quality bar, release gate, and public artifacts
+- [`docs/limitations.md`](docs/limitations.md): project scope, known limits, and roadmap
+
+## Status
+
+Alpha: `0.3.25`.
+
+Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
+
+Platform support targets macOS, Linux, and Windows PowerShell with Git for Windows. `cmd.exe` and bare Git setups are not supported yet.
+
+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.
+
+## License
+
+MIT

{agentpack_cli-0.3.23 → agentpack_cli-0.3.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.23"
+version = "0.3.25"
 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."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.23 → agentpack_cli-0.3.25}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — task-aware context packing for AI coding agents."""
 
-__version__ = "0.3.23"
+__version__ = "0.3.25"

{agentpack_cli-0.3.23 → agentpack_cli-0.3.25}/src/agentpack/cli.py

@@ -42,6 +42,7 @@ from agentpack.commands import (
     task_cmd,
     threads,
     tune,
+    upgrade,
     verify_wheel,
     watch,
     wrap,
@@ -95,6 +96,7 @@ for mod in [
     diagnose_selection,
     eval_cmd,
     tune,
+    upgrade,
     watch,
     claude_cmd,
     benchmark,

{agentpack_cli-0.3.23 → agentpack_cli-0.3.25}/src/agentpack/commands/ci_cmd.py

@@ -79,6 +79,8 @@ jobs:
     if: github.event_name == 'push'
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
@@ -86,5 +88,5 @@ jobs:
         with:
           node-version: "20"
       - run: python -m pip install -e ".[dev]" build
-      - run: python -m agentpack.cli release-check
+      - run: python -m agentpack.cli release-check --profile auto
 """

{agentpack_cli-0.3.23 → agentpack_cli-0.3.25}/src/agentpack/commands/dev_check.py

@@ -27,7 +27,7 @@ def register(app: typer.Typer) -> None:
         stages = [
             CheckStage("docs-check", [sys.executable, "-m", "pytest", "tests/test_docs_links.py", "-q"]),
             CheckStage("ruff", [sys.executable, "-m", "ruff", "check", "src", "tests"]),
-            CheckStage("pytest", [sys.executable, "-m", "pytest", "-q"]),
+            CheckStage("pytest", [sys.executable, "-m", "pytest", "-q", "-m", "not slow"]),
             CheckStage("npm-version-sync", ["node", "npm/test/version-sync.test.js"]),
             CheckStage("npm-launcher", ["node", "npm/test/launcher.test.js"]),
         ]