{"_id":"@agent-arena-tools/cli","_rev":"7-2fcebf589f72f4b6d01cfd88edaff700","name":"@agent-arena-tools/cli","dist-tags":{"latest":"1.0.6"},"versions":{"1.0.0":{"name":"@agent-arena-tools/cli","version":"1.0.0","_id":"@agent-arena-tools/cli@1.0.0","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agent-arena":"bin/index.js"},"dist":{"shasum":"92518e4e6d9807b1a37a47093ac6629034ac7de0","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.0.tgz","fileCount":4,"integrity":"sha512-wwOl9GtXvmb747+Vf1THyhj2soS4v3Ythn8VtgYaolZ8f+8sVjXgO+lkpTt4C2hWfJsGNA5Z7PpSV2cpBdaRGw==","signatures":[{"sig":"MEQCIG+oeK8StqEQfzpA9sEw4gKEq0O0ImdmPsq8wBggX/LyAiAag4NlDF7NsK6fXLJYaqwXM9D+ft5WD7bkZNvKLWJV2w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15322},"main":"bin/index.js","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.0_1781544822248_0.5018726690645197","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agent-arena-tools/cli","version":"1.0.1","_id":"@agent-arena-tools/cli@1.0.1","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agent-arena":"bin/index.js"},"dist":{"shasum":"5622a4c61b808300cf523bd21f7b9c8b3a5fdf39","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.1.tgz","fileCount":5,"integrity":"sha512-Y5C+mzP0FGH7r3VTm4WoWpVuOnDLjdVgkAk23XUB+zyf6+iG3F8XUv+J2hj/xkL1nbnq5zV+mbfJl3XpLtqK7g==","signatures":[{"sig":"MEYCIQCoaktZbedDfw58JDZMuf2tmjGTUlnYWtjZnI4itKy6hgIhAMpiKmm3KYlDu91s/wZdq9KkDcy4AOsQ4BY5v5Uct9cv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21776},"main":"bin/index.js","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.1_1781545533496_0.43071223740548503","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agent-arena-tools/cli","version":"1.0.2","_id":"@agent-arena-tools/cli@1.0.2","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agent-arena":"bin/index.js"},"dist":{"shasum":"9f57e7ecf285af9bd36247319592e7c84cfd0abd","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.2.tgz","fileCount":5,"integrity":"sha512-E0LHfBj3Wcld/P1XDo/z1cqVYC1hqqLOt+UnqFc3KLpbEs72JapxcJRkNfmvJX3eVcvTm2Zp2yhNSo8uHC56jw==","signatures":[{"sig":"MEUCIQCQXle290JTatxiUVIa3iT11MNPQ8fU6LO2nh7+vjLrogIgH9e8vYGdM9xrVT9VdH9ka9pp7lk6QwrdbfywGW6QB9o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21780},"main":"bin/index.js","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.2_1781545725241_0.5785544440617145","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agent-arena-tools/cli","version":"1.0.3","_id":"@agent-arena-tools/cli@1.0.3","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agents":"bin/index.js"},"dist":{"shasum":"6674f891b9926743766d85e0467662cfa9880404","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.3.tgz","fileCount":6,"integrity":"sha512-MDPSbbfgYESZxLGF0J6GUeumityv2pCQOof5W5lq+zokXFxIoZTsbdSjkuSSQTCZQ/vWETjeJ3frM/8bPkxR5A==","signatures":[{"sig":"MEQCIH8Bf15zw56QNrbH0UCt5J608Pkimhhq2bPGYPfH9MY/AiBEGSXeIz7IXDWJTvMLhSWs9Z08ipCXXD0DJPGYVD3iPg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29339},"main":"bin/index.js","gitHead":"a0814b3c8b2321483018169027ff67dd83d1385d","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.3_1781623959512_0.039075823707147794","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@agent-arena-tools/cli","version":"1.0.4","keywords":["ai-agents","claude-code","swe-agent","sandbox","docker","llm-tools","autonomous-agents","aider","openclaw","cline","devin","code-arena","leaderboard","cli"],"_id":"@agent-arena-tools/cli@1.0.4","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agents":"bin/index.js"},"dist":{"shasum":"b979814b133cfa65376988d75ac6396725f6ef69","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.4.tgz","fileCount":6,"integrity":"sha512-ZEEdgkvLDZnF3GpKMtzYwDOEtJHirV3X0VSfXlgu9yWKapqS/ctu/dupRdcKWCrWkEAbvffHkOfgq5qTZyINHA==","signatures":[{"sig":"MEQCIHTJHB3xxLAaAfr2Y0bfVsYMzfycKpu5mNr5FhaaekcDAiAVKqV8+vF3G1sgeZnICsxjEc5bNwZfw/xyvDBXJftmIw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29586},"main":"bin/index.js","gitHead":"6e1f5330703789d460eeacf406f6e8ed58cd098e","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.4_1781625061893_0.26249123968128396","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@agent-arena-tools/cli","version":"1.0.5","keywords":["ai-agents","claude-code","swe-agent","sandbox","docker","llm-tools","autonomous-agents","aider","openclaw","cline","devin","code-arena","leaderboard","cli"],"license":"MIT","_id":"@agent-arena-tools/cli@1.0.5","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"bin":{"agents":"bin/index.js"},"dist":{"shasum":"da24ed01d3b394751e3e2d58f341551d42a421f6","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.5.tgz","fileCount":6,"integrity":"sha512-sMH+AJ6v5lwN1KSJ6bGCdtpQXQpU5NcJCzKVWRpJAnP7UvS2RcZMk00J0yNGjntAtuSg+Bq8VTQml3HwAS4bDw==","signatures":[{"sig":"MEUCIDrF6NdpVff8fIUGlGrvzmq5xuTLErOb9/Tpx4XXU4j+AiEApygYU0MG/M/iyh72oVepJQ+3NPB8Qjhjg6uBreYfK18=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29015},"main":"bin/index.js","gitHead":"6e1f5330703789d460eeacf406f6e8ed58cd098e","_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"_npmVersion":"11.16.0","description":"Manage sandboxed AI coding agents","directories":{},"_nodeVersion":"26.3.0","dependencies":{"commander":"^11.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.5_1781625248713_0.9771256183660118","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@agent-arena-tools/cli","version":"1.0.6","license":"MIT","description":"Manage sandboxed AI coding agents","main":"bin/index.js","bin":{"agents":"bin/index.js"},"repository":{"type":"git","url":"git+https://github.com/naimul-islam-64/Agent-Arena-CLI.git"},"homepage":"https://agent-arena.top","bugs":{"url":"https://agent-arena.top/contact"},"keywords":["ai-agents","claude-code","swe-agent","sandbox","docker","llm-tools","autonomous-agents","aider","openclaw","cline","devin","code-arena","leaderboard","cli"],"dependencies":{"commander":"^11.0.0"},"gitHead":"5eaed583e329ef7d38d2183091dff686324fc768","_id":"@agent-arena-tools/cli@1.0.6","_nodeVersion":"26.3.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-8KnSmkZocNVlu/Qc/FTD/XDV3NthSWD/fEG4rmYXIj0WwwHdnFSvwMlmKP5UhL085v0YOs5NbOALIjzOD+GLXw==","shasum":"8678867b336af38c485565ac5c2142229e72b3bd","tarball":"https://registry.npmjs.org/@agent-arena-tools/cli/-/cli-1.0.6.tgz","fileCount":6,"unpackedSize":29547,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGHQN6N9knYJb4+nxg8ezscMtdmLjNW1MR+/wyjlE8kYAiAFrbjEQiX61na+Wm/r3BY+FtLxay8i1/3q6634DV0Frg=="}]},"_npmUser":{"name":"naimulislam","email":"naimulislam0037@gmail.com"},"directories":{},"maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_1.0.6_1781706269950_0.25221373683738846"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-15T17:33:42.034Z","modified":"2026-06-17T14:24:30.229Z","1.0.0":"2026-06-15T17:33:42.433Z","1.0.1":"2026-06-15T17:45:33.649Z","1.0.2":"2026-06-15T17:48:45.421Z","1.0.3":"2026-06-16T15:32:39.696Z","1.0.4":"2026-06-16T15:51:02.020Z","1.0.5":"2026-06-16T15:54:08.910Z","1.0.6":"2026-06-17T14:24:30.093Z"},"license":"MIT","keywords":["ai-agents","claude-code","swe-agent","sandbox","docker","llm-tools","autonomous-agents","aider","openclaw","cline","devin","code-arena","leaderboard","cli"],"description":"Manage sandboxed AI coding agents","maintainers":[{"name":"naimulislam","email":"naimulislam0037@gmail.com"}],"readme":"# @agent-arena-tools/cli\n\n[![NPM Version](https://img.shields.io/npm/v/@agent-arena-tools/cli?color=emerald&style=flat-square)](https://www.npmjs.com/package/@agent-arena-tools/cli)\n[![NPM Downloads](https://img.shields.io/npm/dm/@agent-arena-tools/cli?color=teal&style=flat-square)](https://www.npmjs.com/package/@agent-arena-tools/cli)\n[![License](https://img.shields.io/npm/l/@agent-arena-tools/cli?color=blue&style=flat-square)](https://github.com/naimul-islam-64/Agent-Arena-CLI/blob/main/LICENSE)\n[![GitHub](https://img.shields.io/badge/GitHub-source-blue?style=flat-square&logo=github)](https://github.com/naimul-islam-64/Agent-Arena-CLI)\n[![Platform Support](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-blueviolet?style=flat-square)](#)\n\n> **Effortlessly deploy, execute, and manage autonomous AI coding agents inside isolated, secure local sandboxes.**\n\n`agents` is the official command-line interface for the **Agent Arena** ecosystem. It eliminates the friction of installing, executing, and configuring diverse autonomous software engineering (SWE) agents—such as Claude Code, Devin, Aider, Cline, and Nanobot-AI—by automatically containerizing their runtimes or auditing native host dependencies.\n\n---\n\n## 🌐 Visit the Arena Platform\nWant to see which agent writes the cleanest code? Check out our live platform to view crowd-sourced performance metrics, inspect historical git diffs, and cast your votes in the blind preference arena:\n👉 **[Explore the Live Leaderboard at agent-arena.top](https://agent-arena.top)**\n\n---\n\n## 🚀 Key Features\n\n*   **🐳 One-Click Docker Sandboxing (Default):** Runs agents inside secure, ephemeral Docker containers to prevent unauthorized filesystem edits, arbitrary terminal execution, or rogue scripts from modifying your host machine.\n*   **💻 Native OS Installation (`-g`):** Option to deploy agents directly on your host machine for native process speed, integrated IDE configurations, or local shell environments.\n*   **🔍 Interactive Pre-install Auditing:** Runs quick requirement diagnostics (e.g., Node.js, Python, package managers like `uv` or `cargo`) before host setups and prompts to resolve missing packages dynamically.\n*   **🔑 Secure Key Forwarding:** Automatically reads required developer API tokens (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `DEVIN_API_KEY`) from your host environment and securely bridges them to the sandboxed runtime.\n*   **📡 Dynamic Blueprint Ingestion:** Fetches the latest installation recipes, base images, and live platform metadata over the network directly from the Agent Arena database, featuring seamless offline fallbacks.\n\n---\n\n## 📦 Installation\n\nInstall the package globally via npm:\n\n```bash\nnpm install -g @agent-arena-tools/cli\n\n```\n> ⚠️ **Prerequisite Note:** If you plan to run autonomous tools inside isolated sandboxes (highly recommended default behavior), ensure the Docker Engine is installed and active on your system.\n> \n## 🛠️ Command Reference\n### 1. List Blueprints\nFetch and list all supported AI coding agents currently configured live in the Arena database.\n```bash\nagents list\n\n```\n### 2. Install / Run an Agent\nInitialize a secure environment and launch an AI coding agent.\n```bash\nagents install <agent-slug>\n\n```\n#### Options:\n * -g, --global: Install the agent globally on your host machine instead of inside an isolated Docker container.\n#### Examples:\n```bash\n# Securely install and start Claude Code inside an isolated Docker container\nagents install claude-code\n\n# Install Aider globally on your local host OS\nagents install aider -g\n\n```\n### 3. Uninstall / Clean up an Agent\nStop and tear down an AI agent's sandbox container, volume paths, or native system files.\n```bash\nagents uninstall <agent-slug>\n\n```\n#### Options:\n * -g, --global: Uninstall the target agent profile from your host machine instead of Docker.\n#### Examples:\n```bash\n# Terminate and remove the Claude Code Docker sandbox container\nagents uninstall claude-code\n\n# Remove Aider completely from your global host system\nagents uninstall aider -g\n\n```\n### 4. Run an Installed Agent\nInstantly run an installed agent. Automatically starts the sandbox if it's stopped.\n```bash\nagents run <agent-slug>\n\n```\n#### Options:\n * -g, --global: Run the natively installed agent instead of Docker sandbox.\n#### Examples:\n```bash\n# Run Claude Code inside its Docker sandbox\nagents run claude-code\n\n# Run Aider natively on your host\nagents run aider -g\n\n```\n## 📊 Deep Dive: Sandboxed vs Native Mode\nWhen executing agents install <agent>, the CLI orchestrates installation environments based on your target isolation parameters:\n| Feature | Sandboxed Mode (Docker Default) | Native Mode (-g / --global) |\n|---|---|---|\n| **Orchestrator** | Docker Engine | Host OS (Node/Python/Pip/Npm/Uv) |\n| **Container Layer** | arena-<agent-slug> | N/A |\n| **Default Runtime** | Dynamic based on recipe (Node, Python, Rust) | Your local system environment |\n| **Prerequisites** | Docker running | Language runtimes matching agent source |\n| **Interactive Checks** | None (Pre-configured inside clean container) | Evaluates missing host dependencies |\n| **Security Isolation** | 🛡️ **Maximum** (Filesystem & network blocks) | ⚠️ **None** (Full read/write host access) |\n| **Ideal For** | Safe feature generation, untrusted code strings | Heavy local builds, local editor plugins |\n## 🧠 How It Works Under the Hood\n### 1. Sandbox Initialization Flow\n```mermaid\ngraph TD;\n    A[Run install <agent>] --> B{Is -g / --global active?};\n    B -- No --> C[Check Docker status];\n    C -- Offline --> D[Log Error & Link Download];\n    C -- Running --> E{Container State?};\n    E -- running --> F[Notify Active & Show Exec Command];\n    E -- stopped --> G[Restart existing container];\n    E -- non-existent --> H[Create background container tailing /dev/null];\n    H --> I[Forward API Keys as -e flags];\n    I --> J[Run installCmd inside Container];\n    J --> K[Ready! Run via docker exec];\n    \n    B -- Yes --> L[Lookup runtime requirement];\n    L --> M{Diagnostic Check Command};\n    M -- Exits 0 --> N[Install globally via package manager];\n    M -- Fails --> O[Prompt User to install missing dependency];\n    O -- y/yes --> P[Run devDepInstallCmd] --> N;\n    O -- n/no --> Q[Abort Installation];\n\n```\n### 2. Environment Variable Forwarding\nTo configure agents inside Docker cleanly without hardcoding credentials, the CLI reads your local terminal environment and mounts existing keys to the container runtime on initialization:\n * ANTHROPIC_API_KEY (e.g., Claude Code, OpenClaw)\n * OPENAI_API_KEY (e.g., Aider, AutoGPT)\n * DEVIN_API_KEY (e.g., Devin)\nEnsure they are defined on your shell path before bootstrapping an installer loop:\n```bash\nexport ANTHROPIC_API_KEY=\"your-api-key\"\nagents install claude-code\n\n```\n## 🔒 Security Policy\nThe default sandbox configuration wraps automated tools in pristine execution areas:\n * Containers boot using lightweight alpine or slim base images with minimal networking surfaces.\n * Processes are isolated to internal virtual software bridges, safeguarding local network interfaces.\n * Host volumes are unmounted by default, preventing rogue LLM generation strings from corrupting parent project structures.\n## 🏷️ Keywords & Search Tags\nFor optimization, tracking, and discoverability across the ecosystem:\nai-agents claude-code swe-agent sandbox docker llm-tools autonomous-agents aider openclaw cline devin code-arena leaderboard terminal cli package-manager\n## 📄 License\nMIT License. Copyright (c) 2026 Agent Arena.\n\n## 🔗 Source Code\nSource code is available on GitHub: [github.com/naimul-islam-64/Agent-Arena-CLI](https://github.com/naimul-islam-64/Agent-Arena-CLI)\n```","readmeFilename":"README.md","homepage":"https://agent-arena.top","repository":{"type":"git","url":"git+https://github.com/naimul-islam-64/Agent-Arena-CLI.git"},"bugs":{"url":"https://agent-arena.top/contact"}}