agentpool-cli 0.1.8__tar.gz → 0.1.10__tar.gz

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+## 0.1.10 - 2026-06-03
+
+- Add an AI-agent start section to root help pointing agents at bundled skill
+  guidance before they infer workflows from flags.
+- Add `agentpool skills` with `list`, `get`, and `path` so agents can load
+  version-matched AgentPool usage guidance from the installed CLI.
+- Include examples with packaged docs so `agentpool skills get core --full`
+  returns both the skill and copy-paste CLI flows.
+
+## 0.1.9 - 2026-06-02
+
+- Harden agent-facing CLI recovery with examples on root/group help, structured
+  `models` action errors, and next-command hints for invalid output choices.
+- Add side-effect-free previews for `preferences init`, `interrupt`, and
+  `leases release`; add `session show --plain`.
+- Format `terminate`, `collect`, and `artifacts` human output without raw Python
+  dicts while preserving JSON payloads.
+- Ship `python -m agentpool` support and expand CLI regression coverage.
+
 ## 0.1.8 - 2026-06-01
 
 - Treat stale usage snapshots as age metadata, not as an unusable-provider

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpool-cli
-Version: 0.1.8
+Version: 0.1.10
 Summary: Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom.
 Author: AgentPool contributors
 License-Expression: MIT
@@ -103,6 +103,13 @@ notes.
 
 ## Quickstart
 
+For AI agents, start by loading the bundled version-matched skill:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool setup cursor
@@ -131,8 +138,10 @@ agentpool observe <session-id> --wait-for completed,error,question,approval_prom
 agentpool send <session-id> "Continue with the smallest useful check."
 agentpool artifacts <session-id> --json
 agentpool transcript <session-id> --tail-lines 80 --json
+agentpool session show <session-id> --json
 agentpool sessions --recent 10 --json
 agentpool collect <session-id> --json
+agentpool terminate <session-id> --dry-run --json
 agentpool terminate <session-id> --json
 ```
 
@@ -153,6 +162,7 @@ agentpool spawn \
   --isolation worktree
 
 agentpool worktrees list --repo .
+agentpool worktrees cleanup --session-id <session-id> --dry-run --json
 agentpool worktrees cleanup --session-id <session-id>
 ```
 
@@ -164,6 +174,7 @@ requested through `--isolation worktree` or policy configuration.
 
 ```bash
 agentpool usage-summary --refresh --json
+agentpool usage-summary --refresh --no-interactive --json
 agentpool stats --since 7d --json
 agentpool usage-summary --refresh --backend codexbar --json
 agentpool usage-summary --refresh --backend ccusage --provider claude-code --json
@@ -185,7 +196,8 @@ in `~/.agentpool/config.yaml`.
 AgentPool still does not pick an alternative provider for you.
 MCP usage refreshes are intentionally bounded and may return `partial=true`;
 use the CLI commands above when a shell-capable agent needs a complete live
-refresh.
+refresh. Use `--no-interactive` or `AGENTPOOL_NO_INTERACTIVE_USAGE=1` when a
+shell script must avoid provider TUI fallback probes.
 
 ## Provider Matrix
 
@@ -307,6 +319,9 @@ summary, provider models, preferences, spawn, observe, send, interrupt,
 collect, artifact manifest, transcript paging, and terminate. Add opt-in
 toolsets with `agentpool mcp --toolsets default,stats,sessions,leases,worktrees`.
 
+Shell-capable agents can use `agentpool skills get agentpool` instead of MCP
+resources to load the same core usage guidance from the installed CLI.
+
 Coding agents with shell access should prefer the CLI path. It is more
 token-efficient because large worker output stays in artifact files and
 `observe`/`collect` return compact manifests by default. MCP remains first-class

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/README.md

@@ -82,6 +82,13 @@ notes.
 
 ## Quickstart
 
+For AI agents, start by loading the bundled version-matched skill:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool setup cursor
@@ -110,8 +117,10 @@ agentpool observe <session-id> --wait-for completed,error,question,approval_prom
 agentpool send <session-id> "Continue with the smallest useful check."
 agentpool artifacts <session-id> --json
 agentpool transcript <session-id> --tail-lines 80 --json
+agentpool session show <session-id> --json
 agentpool sessions --recent 10 --json
 agentpool collect <session-id> --json
+agentpool terminate <session-id> --dry-run --json
 agentpool terminate <session-id> --json
 ```
 
@@ -132,6 +141,7 @@ agentpool spawn \
   --isolation worktree
 
 agentpool worktrees list --repo .
+agentpool worktrees cleanup --session-id <session-id> --dry-run --json
 agentpool worktrees cleanup --session-id <session-id>
 ```
 
@@ -143,6 +153,7 @@ requested through `--isolation worktree` or policy configuration.
 
 ```bash
 agentpool usage-summary --refresh --json
+agentpool usage-summary --refresh --no-interactive --json
 agentpool stats --since 7d --json
 agentpool usage-summary --refresh --backend codexbar --json
 agentpool usage-summary --refresh --backend ccusage --provider claude-code --json
@@ -164,7 +175,8 @@ in `~/.agentpool/config.yaml`.
 AgentPool still does not pick an alternative provider for you.
 MCP usage refreshes are intentionally bounded and may return `partial=true`;
 use the CLI commands above when a shell-capable agent needs a complete live
-refresh.
+refresh. Use `--no-interactive` or `AGENTPOOL_NO_INTERACTIVE_USAGE=1` when a
+shell script must avoid provider TUI fallback probes.
 
 ## Provider Matrix
 
@@ -286,6 +298,9 @@ summary, provider models, preferences, spawn, observe, send, interrupt,
 collect, artifact manifest, transcript paging, and terminate. Add opt-in
 toolsets with `agentpool mcp --toolsets default,stats,sessions,leases,worktrees`.
 
+Shell-capable agents can use `agentpool skills get agentpool` instead of MCP
+resources to load the same core usage guidance from the installed CLI.
+
 Coding agents with shell access should prefer the CLI path. It is more
 token-efficient because large worker output stays in artifact files and
 `observe`/`collect` return compact manifests by default. MCP remains first-class

agentpool_cli-0.1.10/docs/examples.md

@@ -0,0 +1,49 @@
+# Examples
+
+Load agent guidance from the installed CLI:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
+Spawn a fake question worker:
+
+```bash
+agentpool spawn \
+  --provider fake-question \
+  --repo . \
+  --task "Inspect the project and ask one clarifying question." \
+  --isolation read_only
+```
+
+Observe and steer:
+
+```bash
+agentpool observe <session-id> --wait-for question,completed,error --timeout 120 --json
+agentpool send <session-id> "Inspect migrations first. Stay read-only."
+agentpool session show <session-id> --json
+agentpool collect <session-id> --json
+agentpool terminate <session-id> --dry-run --json
+agentpool terminate <session-id>
+```
+
+Read task text from stdin:
+
+```bash
+cat task.md | agentpool spawn --provider <provider-id> --repo . --stdin --json
+```
+
+Run usage probes without provider TUI fallbacks:
+
+```bash
+AGENTPOOL_NO_INTERACTIVE_USAGE=1 agentpool usage-summary --refresh --json
+agentpool usage --provider claude-code --no-interactive --json
+```
+
+Preview worktree cleanup before removing anything:
+
+```bash
+agentpool worktrees cleanup --session-id <session-id> --dry-run --json
+agentpool worktrees cleanup --session-id <session-id> --force --json
+```

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/docs/quickstart.md

@@ -7,6 +7,14 @@ plane, not a router: you pick the provider and model explicitly.
 
 ## 1. Verify the environment
 
+AI agents should load the bundled version-matched skill before inferring flows
+from flags:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool doctor --deep --privacy
@@ -29,8 +37,12 @@ cycle. `"ok": true` means the control plane works end to end.
 ```bash
 agentpool inventory --json
 agentpool usage-summary --json          # add --refresh for live probes
+agentpool usage-summary --refresh --no-interactive --json
 ```
 
+Use `--no-interactive` or `AGENTPOOL_NO_INTERACTIVE_USAGE=1` for scripts that
+must avoid provider TUI fallback probes.
+
 ## 4. Run a real worker (explicit provider + isolation)
 
 ```bash
@@ -44,7 +56,9 @@ The result includes a top-level `session_id`. Drive it with:
 ```bash
 agentpool observe <session-id> --wait-for question,completed,error --timeout 120 --json
 agentpool send <session-id> "Continue with the smallest useful check." --json
+agentpool session show <session-id> --json
 agentpool collect <session-id> --json
+agentpool terminate <session-id> --dry-run --json
 agentpool terminate <session-id> --json
 ```
 
@@ -52,6 +66,7 @@ Use `--isolation worktree` instead of `read_only` for tasks that edit files.
 
 ## Next
 
+- CLI agent guidance: `agentpool skills get agentpool`
 - Full agent guidance: `agentpool://skill.md`
 - Setup and privacy detail: `agentpool://onboarding`
 - User delegation preferences: `agentpool://preferences.md`

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/docs/security.md

@@ -16,8 +16,10 @@ Guardrails:
   key, URI-password, JWT, and private-key patterns.
 
 Live usage probes are explicit. `inventory` does not run provider TUIs or
-network quota probes. `usage --refresh` and `usage-summary --refresh` may read
-existing CLI auth state and contact provider APIs, depending on the provider.
+network quota probes. `usage` and `usage-summary --refresh` may read existing
+CLI auth state and contact provider APIs, depending on the provider. Use
+`--no-interactive` or `AGENTPOOL_NO_INTERACTIVE_USAGE=1` when automation must
+avoid provider TUI fallback probes.
 
 Worker output is an untrusted channel. CLI and MCP observe/collect paths return
 summary metadata by default; inline excerpts and transcript/event resources are

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/docs/usage-detection.md

@@ -4,7 +4,7 @@ Usage is best effort and confidence-tagged. Unknown is valid.
 
 Allowed confidence values include `official`, `local_cli`, `local_config`, `provider_warning`, `observed`, `user_configured`, and `unknown`. AgentPool does not fabricate exact quotas and does not scrape browser sessions in v0.1.
 
-Live probes are only run by explicit usage requests. Inventory remains non-invasive and reports whether a provider supports an explicit usage probe. Successful explicit probes are persisted to SQLite; `agentpool usage --cached`, `get_usage_summary(refresh=false)`, and `get_usage_snapshot(refresh=false)` read the latest persisted snapshots without refreshing providers. MCP refreshes do not run interactive provider TUI probes, because those can interfere with the host agent that is calling AgentPool. MCP refreshes are also bounded by a short server-side budget; if a provider is slow, AgentPool returns a partial response with an unknown row instead of holding the MCP connection open.
+Live probes are only run by explicit usage requests. Inventory remains non-invasive and reports whether a provider supports an explicit usage probe. Successful explicit probes are persisted to SQLite; `agentpool usage --cached`, `get_usage_summary(refresh=false)`, and `get_usage_snapshot(refresh=false)` read the latest persisted snapshots without refreshing providers. MCP refreshes do not run interactive provider TUI probes, because those can interfere with the host agent that is calling AgentPool. CLI callers can use `--no-interactive` on `usage` / `usage-summary`, or set `AGENTPOOL_NO_INTERACTIVE_USAGE=1`, to take the same headless posture. MCP refreshes are also bounded by a short server-side budget; if a provider is slow, AgentPool returns a partial response with an unknown row instead of holding the MCP connection open.
 
 `agentpool usage-summary` returns a `providers` map keyed by provider id. The
 CLI `capacity-summary` command is a human convenience alias; MCP does not expose

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentpool-cli"
-version = "0.1.8"
+version = "0.1.10"
 description = "Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -54,5 +54,6 @@ include = [
 
 [tool.hatch.build.targets.wheel.force-include]
 "docs/agentpool-skill.md" = "agentpool/docs/agentpool-skill.md"
+"docs/examples.md" = "agentpool/docs/examples.md"
 "docs/onboarding.md" = "agentpool/docs/onboarding.md"
 "docs/quickstart.md" = "agentpool/docs/quickstart.md"

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.sidduHERE/agentpool",
   "title": "AgentPool",
   "description": "See each coding-agent subscription's live limits and offload work to one with headroom.",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "repository": {
     "url": "https://github.com/sidduHERE/agentpool",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "agentpool-cli",
-      "version": "0.1.8",
+      "version": "0.1.10",
       "transport": {
         "type": "stdio"
       },

{agentpool_cli-0.1.8 → agentpool_cli-0.1.10}/src/agentpool/__init__.py

@@ -1,3 +1,3 @@
 """AgentPool local agent control plane."""
 
-__version__ = "0.1.8"
+__version__ = "0.1.10"

agentpool_cli-0.1.10/src/agentpool/__main__.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from agentpool.cli import app
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()