{"_id":"@almyty/runner","name":"@almyty/runner","dist-tags":{"latest":"1.2.0"},"versions":{"1.2.0":{"name":"@almyty/runner","version":"1.2.0","publishConfig":{"access":"public"},"description":"Connect your own machine to almyty — a small daemon that lets agents run tools and coding CLIs locally, with code and credentials staying on your box.","type":"module","main":"dist/index.js","bin":{"almyty-runner":"dist/cli.js"},"scripts":{"build":"tsc && chmod +x dist/cli.js","dev":"tsx src/cli.ts","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run build"},"engines":{"node":">=20"},"dependencies":{"node-pty":"^1.0.0","@almyty/client":"^1.2.0"},"devDependencies":{"@types/node":"^25.4.0","tsx":"^4.7.0","typescript":"^5.3.0","vitest":"^4.1.0"},"keywords":["almyty","runner","daemon","agent","cli"],"author":{"name":"almyty"},"license":"Apache-2.0","homepage":"https://almyty.com","repository":{"type":"git","url":"git+https://github.com/almyty-inc/almyty.git","directory":"packages/runner"},"bugs":{"url":"https://github.com/almyty-inc/almyty/issues"},"gitHead":"41ec65ce0d78bc89851e0492c4fa7c20d00b4758","types":"./dist/index.d.ts","_id":"@almyty/runner@1.2.0","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-6eOIpEiai0TN+omxIlSmewpBvIOUGLHSoTOqIOfW1tLHRAs4ngXy6mpPzmhj6MTp+PxMuOC0V+ZDNVOu/7otwg==","shasum":"ba8ebcf007744132d6ae98cdba89f9797cfcd932","tarball":"https://registry.npmjs.org/@almyty/runner/-/runner-1.2.0.tgz","fileCount":59,"unpackedSize":220175,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICDDoiUOblB1TV6cI63ySAlfFkSKbII8EuHKRKNIiDQvAiEA7LXEbzcpJRFrZlS2v5KnGOR2otFENUjPSfqERj389s4="}]},"_npmUser":{"name":"fbandov","email":"frane.bandov@gmail.com"},"directories":{},"maintainers":[{"name":"fbandov","email":"frane.bandov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/runner_1.2.0_1784829754113_0.40415902370263956"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-23T18:02:34.010Z","1.2.0":"2026-07-23T18:02:34.259Z","modified":"2026-07-23T18:02:34.468Z"},"maintainers":[{"name":"fbandov","email":"frane.bandov@gmail.com"}],"description":"Connect your own machine to almyty — a small daemon that lets agents run tools and coding CLIs locally, with code and credentials staying on your box.","homepage":"https://almyty.com","keywords":["almyty","runner","daemon","agent","cli"],"repository":{"type":"git","url":"git+https://github.com/almyty-inc/almyty.git","directory":"packages/runner"},"author":{"name":"almyty"},"bugs":{"url":"https://github.com/almyty-inc/almyty/issues"},"license":"Apache-2.0","readme":"# @almyty/runner\n\nA long-running CLI daemon that executes processes on a user's machine on behalf of almyty agents. Lets a workflow orchestrate any CLI coding agent (Claude Code, Codex, Gemini, aider, …) on your codebase, in one coherent workspace.\n\n## Install\n\n```\nnpx @almyty/runner start --name my-laptop\n```\n\nThree commands in three minutes:\n\n```\nnpx @almyty/auth login          # if you haven't already\nnpx @almyty/runner start --name my-laptop --label os=macos\n# in another terminal:\nnpx @almyty/runner status\n```\n\nStop with `npx @almyty/runner stop` or ctrl-c in the daemon's terminal.\n\nOr use the UI: log into your almyty account and head to **Runners → Start a runner**. The page generates the exact start command for you and waits for the daemon to come online before redirecting to the runner detail.\n\n## What the runner does\n\nThe runner exposes a small process surface (spawn, write, read, signal, wait_for_idle, wait, list, shell.exec, runner.info) over a persistent connection to almyty. Agents call those methods, scoped to a workspace, and the runner runs the actual processes on your machine. It does not bake in any tool-specific knowledge: there is no `claude_code.run` or `codex.run`. Tool intelligence lives in agent prompts; the runner is generic.\n\n## Config\n\nJSON, layered lowest precedence first:\n\n1. Built-in defaults (most restrictive: container isolation, no installs, no network)\n2. `~/.almyty/config.json` (global)\n3. `./.almyty/config.json` (project-local)\n4. Environment variables (`ALMYTY_URL`, `ALMYTY_TOKEN`, `ALMYTY_RUNNER_NAME`, `ALMYTY_RUNNER_ISOLATION`)\n5. CLI flags (`--name`, `--label`, `--config`, `--url`)\n6. Backend overrides (constrain-only; never escalate)\n\nA minimal `~/.almyty/config.json`:\n\n```json\n{\n  \"name\": \"my-laptop\",\n  \"labels\": { \"env\": \"dev\", \"os\": \"macos\" },\n  \"config\": {\n    \"defaultIsolation\": \"host\",\n    \"maxConcurrent\": 4,\n    \"allowedCwdRoots\": [\"/Users/frane/workspace\"],\n    \"denyPatterns\": [],\n    \"networkBlocked\": false,\n    \"installBlocked\": true\n  }\n}\n```\n\n## Architecture\n\nSee [docs/runner.md](../../docs/runner.md) for the load-bearing design decisions: Streamable HTTP transport, no per-tool wrappers, PTY by default, detected vs configured fields, resource scoping, and config layering.\n\n.\n\n## About almyty\n\nalmyty is the full-stack platform for AI agents, agnostic by design: any LLM, any\nAPI turned into tools, served over MCP, A2A, UTCP, and Agent Skills. Open source,\nno lock-in.\n\n- Website — https://almyty.com\n- Docs — https://docs.almyty.com\n- Source — https://github.com/almyty-inc/almyty\n\nApache-2.0 © Almyty Inc.\n","readmeFilename":"README.md","_rev":"1-2afa3250e4d9b9e66b43a4e0aec3c93c"}