{"_id":"@baldaworks/acprun","_rev":"9-54bb2a0b50bf059f92e34a2f45f8531b","name":"@baldaworks/acprun","dist-tags":{"latest":"0.1.8"},"versions":{"0.1.0":{"name":"@baldaworks/acprun","version":"0.1.0","_id":"@baldaworks/acprun@0.1.0","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"1949120597ad8a519fefb5c8a3ad0ca3f6559868","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.0.tgz","fileCount":3,"integrity":"sha512-cPuFKIpI5cPLKmfVvYJd0d3Qv7l+LaN/ya2nD2mMXD2f9KaFUD7FRRG/acWmdNGkTFCNZuEatQwMQjsbrIEMzw==","signatures":[{"sig":"MEUCIEvypJVn7gKACSlVObLKdjpaMuge9CLOF272ki6SCkNSAiEAvWSNVyzPLrGQ8d74a8LCKZWXhWhmdyJbrKUWNlXwlTA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6544},"engines":{"node":">=16"},"gitHead":"762e55282a2b9923c61b4abca59db60dd874002c","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.0","@baldaworks/acprun-win32-x64":"0.1.0","@baldaworks/acprun-darwin-x64":"0.1.0","@baldaworks/acprun-linux-arm64":"0.1.0","@baldaworks/acprun-win32-arm64":"0.1.0","@baldaworks/acprun-darwin-arm64":"0.1.0"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.0_1788155282125_0.22170335144563302","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@baldaworks/acprun","version":"0.1.1","_id":"@baldaworks/acprun@0.1.1","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"46aa3c9419167279d1cee8eaf87c2863ee7a72e2","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.1.tgz","fileCount":3,"integrity":"sha512-G8DsOB1RgMXCRyMhE4D4lUjS39plV4ziMRQGFQcrbtWvEuLgw9r+tvWOVYL+u/rQVjgC8ykZjaZ4LZJAnr1Rfg==","signatures":[{"sig":"MEYCIQDz4U85RC5+0EdFlQ4txKt2IbTmvMeEukBwO5KLFe4EHAIhALuSQrpcweyLtNhxu7h8qyFEIIpMgotZNyFm0P4T4qFl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6544},"engines":{"node":">=16"},"gitHead":"a78757d9395739dfd09136bc3adf9e883435e33d","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.1","@baldaworks/acprun-win32-x64":"0.1.1","@baldaworks/acprun-darwin-x64":"0.1.1","@baldaworks/acprun-linux-arm64":"0.1.1","@baldaworks/acprun-win32-arm64":"0.1.1","@baldaworks/acprun-darwin-arm64":"0.1.1"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.1_1788155548938_0.7335786135400482","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@baldaworks/acprun","version":"0.1.2","_id":"@baldaworks/acprun@0.1.2","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"b380c9589387ebe793b728f708a2faf5a613fd3f","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.2.tgz","fileCount":3,"integrity":"sha512-eRcW2dcy9fW1nmwv7BJVxHv5EAZueg1gldVJTkBUJE9djaSniHtBwMYb2BTn+jphZFOnA5W1CVLIucUpZRlvfg==","signatures":[{"sig":"MEYCIQD1F5zGOJaUypUauo2Lu7DnB4To8qs+0gLQ70LkndSaRAIhAMeDlP8X7omC3Rs0mdRQzsnUM6aLdC18WVov3y4tMRM7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6544},"engines":{"node":">=16"},"gitHead":"a78757d9395739dfd09136bc3adf9e883435e33d","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.2","@baldaworks/acprun-win32-x64":"0.1.2","@baldaworks/acprun-darwin-x64":"0.1.2","@baldaworks/acprun-linux-arm64":"0.1.2","@baldaworks/acprun-win32-arm64":"0.1.2","@baldaworks/acprun-darwin-arm64":"0.1.2"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.2_1788155805149_0.12291347268714037","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@baldaworks/acprun","version":"0.1.3","license":"SEE LICENSE IN LICENSE","_id":"@baldaworks/acprun@0.1.3","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"53962dddf18c2aa9d23c4c95e5c3e2291f2dcf5b","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.3.tgz","fileCount":4,"integrity":"sha512-BzxQ0qh1PEjiYInOtI3gZPsmEXDfixBYF72rKc2nerOYODiPXH0AQPcmNh8ARgAfJtCr6DohZsPcmrEUcYtC5Q==","signatures":[{"sig":"MEQCIE6f13xRZD17T69DPdjfbYEnjQB8T3KpMsfXm2AcfWi9AiAiwRAL56F1kFosEwEi2w+3D+eOZ1Tc4mCkpzPwxuV9kA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9722},"engines":{"node":">=16"},"gitHead":"e7bf235680fd28bd517af6836425922c45330bc1","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.3","@baldaworks/acprun-win32-x64":"0.1.3","@baldaworks/acprun-darwin-x64":"0.1.3","@baldaworks/acprun-linux-arm64":"0.1.3","@baldaworks/acprun-win32-arm64":"0.1.3","@baldaworks/acprun-darwin-arm64":"0.1.3"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.3_1788157168550_0.9776327085054113","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@baldaworks/acprun","version":"0.1.4","license":"SEE LICENSE IN LICENSE","_id":"@baldaworks/acprun@0.1.4","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"c2957d93b29ec252e2dc18f245e231f6a3916f15","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.4.tgz","fileCount":4,"integrity":"sha512-/BxW4WW6yd1LZdl4ai0KbW6NFl/0NZ9sHjLtbjpo4EPxK2xEu3v3d2Z0jwSDaljD5kV6vR3yh9zCVpPzjhyl+Q==","signatures":[{"sig":"MEUCIEBLq2BLtV49+t3rZSfBUMB4YWeIkxbVXT19ibmjUsktAiEA5h1dDFG7QTMBn1PX0iqqN62yS53pnETFpQNf+v+Wtrc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9722},"engines":{"node":">=16"},"gitHead":"bb6430921bc0903cdacd01f3ae027bd0e95437bf","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.4","@baldaworks/acprun-win32-x64":"0.1.4","@baldaworks/acprun-darwin-x64":"0.1.4","@baldaworks/acprun-linux-arm64":"0.1.4","@baldaworks/acprun-win32-arm64":"0.1.4","@baldaworks/acprun-darwin-arm64":"0.1.4"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.4_1788157320006_0.8432421351937525","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@baldaworks/acprun","version":"0.1.5","license":"SEE LICENSE IN LICENSE","_id":"@baldaworks/acprun@0.1.5","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"998f213172d823767215bf626bbd1047a2fd0f06","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.5.tgz","fileCount":4,"integrity":"sha512-Ah8gCa2Y+jBZ1QALNdtHofObn5Z28jdeRrty4nJQ2WLQAzV76jdf5KWF4+rJNRgwSCd0mz45k8SGFXUfces9FA==","signatures":[{"sig":"MEQCIFFHsbBhMYKPAu39Y2uDAc9ysIkveMvUkeNCeKe/9DNsAiB+Ap69j6U89Hgm63IbSogCZcovYJMsbYj60ZatIJBIZw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9722},"engines":{"node":">=16"},"gitHead":"d2187cea33d7aba21d0381bf06308ef795fbe15d","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.5","@baldaworks/acprun-win32-x64":"0.1.5","@baldaworks/acprun-darwin-x64":"0.1.5","@baldaworks/acprun-linux-arm64":"0.1.5","@baldaworks/acprun-win32-arm64":"0.1.5","@baldaworks/acprun-darwin-arm64":"0.1.5"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.5_1788158494710_0.12013972075196921","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@baldaworks/acprun","version":"0.1.6","license":"SEE LICENSE IN LICENSE","_id":"@baldaworks/acprun@0.1.6","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"79d09377ec676140beb11f998d095edfe4e17e84","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.6.tgz","fileCount":4,"integrity":"sha512-v/az/HHu1l60gspxxtmPm2//TW69K45KYj/l7saUG8mvG83iA1vwA3L0xnok5Zm7WV/3z4R8bqBsfZNMN2s/Iw==","signatures":[{"sig":"MEUCIACGsqL9HJmfh3Czut2lj2C9Z4CPCidUi8DKTIxRPDokAiEAgGQ3wOgp2lgeIiPp8PHUObLL/euVOD7ADogg1+0DGKU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9722},"engines":{"node":">=16"},"gitHead":"0725b77d68c216773145504ddd181c0cff8ed107","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.6","@baldaworks/acprun-win32-x64":"0.1.6","@baldaworks/acprun-darwin-x64":"0.1.6","@baldaworks/acprun-linux-arm64":"0.1.6","@baldaworks/acprun-win32-arm64":"0.1.6","@baldaworks/acprun-darwin-arm64":"0.1.6"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.6_1788241040271_0.8963790303264414","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@baldaworks/acprun","version":"0.1.7","license":"SEE LICENSE IN LICENSE","_id":"@baldaworks/acprun@0.1.7","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"bin":{"acprun":"acprun.js"},"dist":{"shasum":"ae5ab17f2a5d352ca0ed2ac065bcf52dc5dc1be3","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.7.tgz","fileCount":4,"integrity":"sha512-B1M3eERGZuTLVhWpwePm5JP7PzxWnUDB7oddOkciSfPKP/qcsRJWLeNLI+wyBieJppkJs34EVixULVt6v1mKeg==","signatures":[{"sig":"MEUCIQDOJHBCEewH46P2ErLtnK59P5lqu2+HW7fBnEu5AtxkLQIgJnv0X38ezG4bQupZfjLtoUQeauNYHxgwgTczl6pcHhw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9722},"engines":{"node":">=16"},"gitHead":"00bce7057894abf56f40f87b876f761f3f985108","_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"_npmVersion":"10.9.8","description":"Meta package for acprun","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"optionalDependencies":{"@baldaworks/acprun-linux-x64":"0.1.7","@baldaworks/acprun-win32-x64":"0.1.7","@baldaworks/acprun-darwin-x64":"0.1.7","@baldaworks/acprun-linux-arm64":"0.1.7","@baldaworks/acprun-win32-arm64":"0.1.7","@baldaworks/acprun-darwin-arm64":"0.1.7"},"_npmOperationalInternal":{"tmp":"tmp/acprun_0.1.7_1788250968660_0.5582779678564809","host":"s3://npm-registry-packages-npm-production"}},"0.1.8":{"bin":{"acprun":"acprun.js"},"description":"Meta package for acprun","engines":{"node":">=16"},"license":"SEE LICENSE IN LICENSE","name":"@baldaworks/acprun","optionalDependencies":{"@baldaworks/acprun-darwin-arm64":"0.1.8","@baldaworks/acprun-darwin-x64":"0.1.8","@baldaworks/acprun-linux-arm64":"0.1.8","@baldaworks/acprun-linux-x64":"0.1.8","@baldaworks/acprun-win32-arm64":"0.1.8","@baldaworks/acprun-win32-x64":"0.1.8"},"version":"0.1.8","_id":"@baldaworks/acprun@0.1.8","gitHead":"e518a9ac4fed002b3ef6eceaede2ea04304ed731","_nodeVersion":"22.23.2","_npmVersion":"10.9.8","dist":{"integrity":"sha512-ELueS+VHnCprDeeK6n4sr0/69THlPUKZrawpRugGVyiQdTn+qBZbl5M5HscWufttOIUKY5Cna7J4H0LeybFhOw==","shasum":"2db86ef4c466dd00cae93b27f871400ae60f4276","tarball":"https://registry.npmjs.org/@baldaworks/acprun/-/acprun-0.1.8.tgz","fileCount":4,"unpackedSize":9830,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDYsOmA9ESPtFbqndlc0PvhcI3sgd2t80OIg4xEQGjESgIhAKw9BeOjOSsfsoOk0I3fkdN3Jjnb+uK1zM8GXQyVQKvH"}]},"_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"directories":{},"maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/acprun_0.1.8_1788696076152_0.47663663251004507"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-31T05:48:02.003Z","modified":"2026-09-06T12:01:16.748Z","0.1.0":"2026-08-31T05:48:02.246Z","0.1.1":"2026-08-31T05:52:29.077Z","0.1.2":"2026-08-31T05:56:45.279Z","0.1.3":"2026-08-31T06:19:28.688Z","0.1.4":"2026-08-31T06:22:00.145Z","0.1.5":"2026-08-31T06:41:34.966Z","0.1.6":"2026-09-01T05:37:20.390Z","0.1.7":"2026-09-01T08:22:48.799Z","0.1.8":"2026-09-06T12:01:16.281Z"},"license":"SEE LICENSE IN LICENSE","description":"Meta package for acprun","maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"readme":"# acprun\n\n[![Test](https://github.com/baldaworks/acprun/actions/workflows/test.yml/badge.svg)](https://github.com/baldaworks/acprun/actions/workflows/test.yml)\n[![Lint](https://github.com/baldaworks/acprun/actions/workflows/lint.yml/badge.svg)](https://github.com/baldaworks/acprun/actions/workflows/lint.yml)\n[![Security](https://github.com/baldaworks/acprun/actions/workflows/security.yml/badge.svg)](https://github.com/baldaworks/acprun/actions/workflows/security.yml)\n[![Latest release](https://img.shields.io/github/v/release/baldaworks/acprun)](https://github.com/baldaworks/acprun/releases/latest)\n[![npm version](https://img.shields.io/npm/v/%40baldaworks%2Facprun)](https://www.npmjs.com/package/@baldaworks/acprun)\n[![License: MIT](https://img.shields.io/github/license/baldaworks/acprun)](LICENSE)\n\n## Universal agent runner and registry client for the Agent Client Protocol (ACP)\n\n`acprun` is a CLI tool, runner, and Go library for discovering, resolving, and running agents published in the [Agent Client Protocol (ACP) Registry](https://agentclientprotocol.com).\n\nIt transparently handles distribution resolution across:\n- **Binary Archives**: Detects host OS and CPU architecture (`linux-x86_64`, `linux-aarch64`, `darwin-aarch64`, `darwin-x86_64`, `windows-x86_64`, `windows-aarch64`), downloads `.zip` or `.tar.gz` archives, validates optional SHA256 integrity checksums, safely extracts to local user cache (with strict Zip Slip protection), sets `0755` executable permissions, and builds the command vector.\n- **NPX Packages**: Formats `[\"npx\", \"-y\", <package>, <args...>]` and sets environment variables.\n- **UVX Packages**: Formats `[\"uvx\", <package>, <args...>]` and sets environment variables.\n- **Offline Resilient Caching**: Caches registry manifests and downloaded binaries under `os.UserCacheDir()/acprun/` for fast, offline reuse.\n\n---\n\n## Installation and quick start\n\n### npm package (recommended)\n\nFor repeated direct shell use, install the npm launcher globally:\n\n```bash\nnpm install --global @baldaworks/acprun@latest\nacprun --version\n```\n\nFor one-shot execution without global installation, run the complete `npx` command:\n\n```bash\nnpx --yes @baldaworks/acprun@latest list\n```\n\n### Go binary\n\n```bash\ngo install github.com/baldaworks/acprun/cmd/acprun@latest\n```\n\n---\n\n## One-shot agent execution\n\n`acprun` supports **one-shot execution** directly without needing explicit subcommands (similar to `npx` or `uvx`):\n\n```bash\n# Run a binary agent\nacprun goose\n\n# Run an NPX agent with arguments\nacprun cline --acp\n\n# Run a UVX agent\nacprun fast-agent -x\n\n# Pass arbitrary flags directly to the agent\nacprun amp-acp --verbose\n```\n\n---\n\n## Agent discovery and inspection\n\n### `acprun list`\nList all agents available in the ACP registry.\n```bash\n# Formatted table\nacprun list\n\n# Filter by distribution format\nacprun list --distribution binary\n\n# JSON output\nacprun list --format json\n```\n\n### `acprun info <agent-id>` (alias: `show`)\nDisplay detailed agent metadata, license, authors, repository, and platform distribution specs.\n```bash\nacprun info devin\nacprun info gemini --json\n```\n\n### `acprun resolve <agent-id>`\nDry-run resolution: downloads and extracts binary archives to local cache if needed, and prints the resolved command vector without running the process.\n```bash\nacprun resolve antigravity-acp --json\nacprun resolve goose --platform linux-x86_64\n```\n\n---\n\n## Explicit runner subcommands\n\nUse explicit runner subcommands (`run`, `serve`, `exec`, `start`) when you want to avoid any potential ambiguity with management subcommands (e.g. running an agent whose ID is `list` or `cache`):\n\n```bash\n# Explicit run\nacprun run cursor -- acp\n\n# Using serve alias\nacprun serve devin\n\n# Pass extra environment variables\nacprun run fast-agent -e FAST_AGENT_MODEL=custom -- -x\n```\n\n---\n\n## Cache management\n\n```bash\n# Print cache directory path\nacprun cache path\n\n# Purge cache\nacprun cache clean --all\nacprun cache clean --manifests-only\n```\n\n---\n\n## CLI reference\n\n### Global Flags\n```text\n  -r, --registry string    ACP Registry URL (default: official CDN, env: ACP_REGISTRY_URL)\n      --cache-dir string   Custom cache directory (default: $USER_CACHE_DIR/acprun, env: ACP_CACHE_DIR)\n      --download-timeout duration\n                           Binary archive download timeout (default 5m0s)\n      --offline            Offline mode: use cached manifests and binaries only\n  -v, --verbose            Enable verbose output\n  -h, --help               Help for acprun\n```\n\n### Subcommands Table\n| Command | Description | Aliases |\n| --- | --- | --- |\n| `acprun <agent-id> [args...]` | One-shot agent resolution and execution | — |\n| `acprun run <agent-id>` | Explicit agent process runner | `serve`, `exec`, `start` |\n| `acprun list` | List available registry agents | `ls` |\n| `acprun info <agent-id>` | Display detailed agent metadata and distributions | `show` |\n| `acprun resolve <agent-id>` | Dry-run resolution to command vector | — |\n| `acprun cache [path\\|clean]` | Inspect or clean local ACP cache | — |\n| `acprun version` | Print version and build metadata | — |\n\n---\n\n## Architecture and security\n\n- **Targeted Package Layout**:\n  - [`cmd/acprun/`](cmd/acprun/): Binary entrypoint.\n  - [`internal/cli/`](internal/cli/): Cobra CLI commands with one-shot dispatch.\n  - [`internal/registry/`](internal/registry/): ACP v1 models, HTTP client, and manifest caching.\n  - [`internal/resolver/`](internal/resolver/): Host platform detection, safe archive extraction (`.zip`, `.tar.gz`, `.tar.bz2`), and Binary/NPX/UVX distribution resolvers.\n  - [`internal/runner/`](internal/runner/): Process execution, stdio binding, and signal forwarding (`SIGINT`, `SIGTERM`).\n- **Security & Integrity**:\n  - **Zip Slip Prevention**: Validates all archive entry paths stay within the target destination directory before extraction.\n  - **SHA256 Verification**: Verifies SHA256 integrity checksums against registry manifests.\n  - **Static Binaries**: Built with `CGO_ENABLED=0` for pure Go cross-platform portability.\n\n---\n\n## Distribution\n\nThe npm distribution uses CGO-disabled native executables for macOS and Linux on AMD64/ARM64 and Windows AMD64/ARM64 behind the [`@baldaworks/acprun`](https://www.npmjs.com/package/@baldaworks/acprun) launcher.\n\n---\n\n## License\n\n`acprun` is released under the [MIT License](LICENSE).\n","readmeFilename":"README.md"}