{"_id":"@aaiconnect/local","name":"@aaiconnect/local","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aaiconnect/local","version":"1.0.0","description":"A.AI Local Agent - Connect your machine to A.AI","bin":{"aai-local":"dist/index.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["aai","hacker","pentesting","security","cli"],"author":{"name":"A.AI"},"license":"MIT","engines":{"node":">=18"},"dependencies":{"convex":"^1.29.2"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.0.0"},"_id":"@aaiconnect/local@1.0.0","gitHead":"b5ddfdc95ebb7a624b8a0dafd440c2f122c1379a","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-igtgZlu3wzPvlLvWMogVTW5JrzyufE4UQUxJyB4CiSE7Eos0a5dUTNoTJWwO+SWwX8fVk81mpesDkDKsrx+tlA==","shasum":"dae074830a0b6dcfb25ef3af347f2f5337deade7","tarball":"https://registry.npmjs.org/@aaiconnect/local/-/local-1.0.0.tgz","fileCount":14,"unpackedSize":76330,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCGfn35rt9ATKeBSiyOELLP3208TNXplXf8BAb1RFA9/QIgUqWgN1qoVgIEjjBcRQl5u66EMFzvuYj956cUCrekk8o="}]},"_npmUser":{"name":"hasannawaz","email":"nawazhasan80@gmail.com"},"directories":{},"maintainers":[{"name":"hasannawaz","email":"nawazhasan80@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/local_1.0.0_1773165429310_0.16281077193737614"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T17:57:09.169Z","1.0.0":"2026-03-10T17:57:09.440Z","modified":"2026-03-10T17:57:09.676Z"},"maintainers":[{"name":"hasannawaz","email":"nawazhasan80@gmail.com"}],"description":"A.AI Local Agent - Connect your machine to A.AI","keywords":["aai","hacker","pentesting","security","cli"],"author":{"name":"A.AI"},"license":"MIT","readme":"# @hackerai/local\n\nHackerAI Local Sandbox Client - Execute commands on your local machine from HackerAI.\n\n## Installation\n\n```bash\nnpx @hackerai/local@latest --token YOUR_TOKEN\n```\n\nOr install globally:\n\n```bash\nnpm install -g @hackerai/local\nhackerai-local --token YOUR_TOKEN\n```\n\n## Usage\n\n### Basic Usage (Docker Mode)\n\n```bash\nnpx @hackerai/local@latest --token hsb_abc123 --name \"My Laptop\"\n```\n\nThis pulls the pre-built HackerAI sandbox image (~3GB) - an AI Agent Penetration Testing Environment based on Kali Linux with comprehensive automated tools including:\nnmap, masscan, sqlmap, ffuf, gobuster, nuclei, hydra, nikto, wpscan, subfinder, httpx, smbclient, impacket, and many more.\n\n### Dangerous Mode (No Docker)\n\n```bash\nnpx @hackerai/local@latest --token hsb_abc123 --name \"Work PC\" --dangerous\n```\n\n**Warning:** Dangerous mode runs commands directly on your host OS without isolation.\n\n## Options\n\n| Option             | Description                                            |\n| ------------------ | ------------------------------------------------------ |\n| `--token TOKEN`    | Authentication token from HackerAI Settings (required) |\n| `--name NAME`      | Connection name shown in HackerAI (default: hostname)  |\n| `--dangerous`      | Run commands directly on host OS without Docker        |\n| `--convex-url URL` | Override backend URL (for development)                 |\n| `--help, -h`       | Show help message                                      |\n\n## Getting Your Token\n\n1. Go to [HackerAI Settings](https://hackerai.co/settings)\n2. Navigate to the \"Agents\" tab\n3. Click \"Generate Token\" or copy your existing token\n\n## Security\n\n- **Docker Mode**: Commands run in a container with process isolation, but with:\n  - Host network access (`--network host`) for pentesting tools to scan network services\n  - Linux capabilities for network tools:\n    - `NET_RAW`: Required for ping, nmap, masscan, hping3, arp-scan, tcpdump, raw sockets\n    - `NET_ADMIN`: Required for network interface manipulation, arp-scan, netdiscover\n    - `SYS_PTRACE`: Required for debugging tools (gdb, strace, ltrace)\n- **Dangerous Mode**: Commands run directly on your OS without any isolation - use with caution\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-a6264f412bb90680eb9aa959592bc70d"}