{"_id":"@5kyguy/k2so","_rev":"4-7eb4dcaf7d521a72b331d52187e838dd","name":"@5kyguy/k2so","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@5kyguy/k2so","version":"0.1.0","keywords":["opencode","agent","desktop","cli","mcp","background-tasks"],"author":{"name":"5kyguy"},"license":"MIT","_id":"@5kyguy/k2so@0.1.0","maintainers":[{"name":"5kyguy","email":"0x5kyguy@gmail.com"}],"homepage":"https://github.com/5kyguy/k-2so#readme","bugs":{"url":"https://github.com/5kyguy/k-2so/issues"},"bin":{"k2so":"dist/cli.js"},"dist":{"shasum":"dc73340dc3123c40de66bd95dbd32bcaddb8e50b","tarball":"https://registry.npmjs.org/@5kyguy/k2so/-/k2so-0.1.0.tgz","fileCount":113,"integrity":"sha512-A+gBMPQAQJ7SIsMpIAfcubeJH1jLfk/IVnOUAVdQoV8DlvwswAtZkBSOd24ul0qcUa3+6CmfXndO9HHvgnS38Q==","signatures":[{"sig":"MEUCIDhP4KtQKud1cp4YcRZgjDoCmLPzXdLtLn3Sr9NwxeWyAiEAn1vxM5LXDe/2m5Ws0VbwFsHHjtXrWOiN2pamkp7SLi8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":237146},"type":"module","engines":{"node":">=20"},"gitHead":"da5db82b3790e797c646bba2ad91a843de830722","scripts":{"dev":"tsc --watch","build":"tsc && npm run build --prefix mcp/memory && node scripts/copy-assets.mjs","start":"node dist/cli.js serve","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"5kyguy","email":"0x5kyguy@gmail.com"},"repository":{"url":"git+https://github.com/5kyguy/k-2so.git","type":"git"},"_npmVersion":"11.6.2","description":"Background task agent for your desktop — the brains to your tool layer","directories":{},"_nodeVersion":"25.3.0","dependencies":{"hono":"^4.7.0","smol-toml":"^1.3.1","@opencode-ai/sdk":"^1.14.0","@hono/node-server":"^1.14.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.13.0"},"_npmOperationalInternal":{"tmp":"tmp/k2so_0.1.0_1782926369492_0.12310881070253465","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@5kyguy/k2so","version":"0.1.1","keywords":["opencode","agent","desktop","cli","mcp","background-tasks"],"author":{"name":"5kyguy"},"license":"MIT","_id":"@5kyguy/k2so@0.1.1","maintainers":[{"name":"5kyguy","email":"0x5kyguy@gmail.com"}],"homepage":"https://github.com/5kyguy/k-2so#readme","bugs":{"url":"https://github.com/5kyguy/k-2so/issues"},"bin":{"k2so":"dist/cli.js"},"dist":{"shasum":"aa436915d9138dd1f1f3f41d4273f7a63728c15d","tarball":"https://registry.npmjs.org/@5kyguy/k2so/-/k2so-0.1.1.tgz","fileCount":113,"integrity":"sha512-VaPswN3gnVBRwcRcgoP+7uCHYm1KzkpuMzAkD6wUagaEi8SyS4+Oi+Q1xpMTHQ4LBxULaaTs++azdCMxA8nRAw==","signatures":[{"sig":"MEUCIHxdF3uLFhPo73SyRu4TLgkE59HQwZ2ucmd0WxoMFVxSAiEA2CoaZR14uBdrewrt9JHE9eKoJRJyFqqPgCkujT6db0I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":276427},"type":"module","engines":{"node":">=20"},"gitHead":"0f72cf02c5a89f082affba0f9c47663a415dc5a0","scripts":{"dev":"tsc --watch","build":"tsc && npm run build --prefix mcp/memory && node scripts/copy-assets.mjs","start":"node dist/cli.js serve","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"5kyguy","email":"0x5kyguy@gmail.com"},"repository":{"url":"git+https://github.com/5kyguy/k-2so.git","type":"git"},"_npmVersion":"11.6.2","description":"Background task agent for your desktop — the brains to your tool layer","directories":{},"_nodeVersion":"25.3.0","dependencies":{"hono":"^4.7.0","smol-toml":"^1.3.1","@opencode-ai/sdk":"^1.14.0","@hono/node-server":"^1.14.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.13.0"},"_npmOperationalInternal":{"tmp":"tmp/k2so_0.1.1_1784348061553_0.13130313311781427","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@5kyguy/k2so","version":"0.1.2","keywords":["opencode","agent","desktop","cli","mcp","background-tasks"],"author":{"name":"5kyguy"},"license":"MIT","_id":"@5kyguy/k2so@0.1.2","maintainers":[{"name":"5kyguy","email":"0x5kyguy@gmail.com"}],"homepage":"https://github.com/5kyguy/k-2so#readme","bugs":{"url":"https://github.com/5kyguy/k-2so/issues"},"bin":{"k2so":"dist/cli.js"},"dist":{"shasum":"d43b59501218c8ed87c4f3f0d80d10df52baed85","tarball":"https://registry.npmjs.org/@5kyguy/k2so/-/k2so-0.1.2.tgz","fileCount":111,"integrity":"sha512-teeKVzHAQsKyzlEw6hbY4wY46xP8puTpr3+zOcNasgOGji1b4fQRgedrEVh1u/0SZ89rqz8Op/CWRo+AUlK+Og==","signatures":[{"sig":"MEQCIC2HacIpI8hLMb2YHpMukdDTEvUdptjqxdiOtJ5ezMtnAiBLXimG3ZVhMyD54L6AGo1kBx4bRFjvbc0MO5tj4qR0wA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@5kyguy%2fk2so@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":282855},"type":"module","engines":{"node":">=20"},"gitHead":"ccdc20cb4c85ce8cd09c46195c1ed76f310dd85f","scripts":{"dev":"tsc --watch","build":"tsc && npm ci --prefix mcp/memory && npm run build --prefix mcp/memory && node scripts/copy-assets.mjs","start":"node dist/cli.js serve","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b1eabec5-7c58-4a6a-949b-1fe0be85eaa8"}},"repository":{"url":"git+https://github.com/5kyguy/k-2so.git","type":"git"},"_npmVersion":"11.16.0","description":"Background task agent for your desktop — the brains to your tool layer","directories":{},"_nodeVersion":"24.18.0","dependencies":{"hono":"^4.7.0","smol-toml":"^1.3.1","@opencode-ai/sdk":"^1.14.0","@hono/node-server":"^1.14.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.13.0"},"_npmOperationalInternal":{"tmp":"tmp/k2so_0.1.2_1784396077906_0.8849360909687571","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@5kyguy/k2so","version":"0.1.3","description":"Background task agent for your desktop — the brains to your tool layer","type":"module","bin":{"k2so":"dist/cli.js"},"scripts":{"build":"tsc && npm ci --prefix mcp/memory && npm run build --prefix mcp/memory && node scripts/copy-assets.mjs","dev":"tsc --watch","prepublishOnly":"npm run build","start":"node dist/cli.js serve","typecheck":"tsc --noEmit"},"author":{"name":"5kyguy"},"repository":{"type":"git","url":"git+https://github.com/5kyguy/k-2so.git"},"homepage":"https://github.com/5kyguy/k-2so#readme","bugs":{"url":"https://github.com/5kyguy/k-2so/issues"},"keywords":["opencode","agent","desktop","cli","mcp","background-tasks"],"engines":{"node":">=20"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@hono/node-server":"^1.14.0","@opencode-ai/sdk":"^1.14.0","hono":"^4.7.0","smol-toml":"^1.3.1"},"devDependencies":{"@types/node":"^22.13.0","typescript":"^5.8.0"},"gitHead":"b96706240f44b3bd32a0fc7c39e85bd6994fa738","_id":"@5kyguy/k2so@0.1.3","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-rpv6mycg5yDxWWWWLUjk9C5m4uEj/sBdKHGLBIUN8yCwqYoVKCZCGUCcNRAjTN1uUgeYCVRhA3rLPcfg1KN9SA==","shasum":"b68d778061421ac41ff5ee7ed16be2251fab0375","tarball":"https://registry.npmjs.org/@5kyguy/k2so/-/k2so-0.1.3.tgz","fileCount":115,"unpackedSize":320632,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@5kyguy%2fk2so@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIF5zFo6BaaAUnZyzTKDvIjqhHr4fCHEPS3MC4TSlLZaxAiAvh+zbqNqUSloWSIw1zgkav/gKlu4n10TZwWbQUPBPBA=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b1eabec5-7c58-4a6a-949b-1fe0be85eaa8"}},"directories":{},"maintainers":[{"name":"5kyguy","email":"0x5kyguy@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/k2so_0.1.3_1784459861036_0.35488909609183095"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T17:19:29.399Z","modified":"2026-07-19T11:17:41.538Z","0.1.0":"2026-07-01T17:19:29.638Z","0.1.1":"2026-07-18T04:14:21.693Z","0.1.2":"2026-07-18T17:34:38.067Z","0.1.3":"2026-07-19T11:17:41.222Z"},"bugs":{"url":"https://github.com/5kyguy/k-2so/issues"},"author":{"name":"5kyguy"},"license":"MIT","homepage":"https://github.com/5kyguy/k-2so#readme","keywords":["opencode","agent","desktop","cli","mcp","background-tasks"],"repository":{"type":"git","url":"git+https://github.com/5kyguy/k-2so.git"},"description":"Background task agent for your desktop — the brains to your tool layer","maintainers":[{"name":"5kyguy","email":"0x5kyguy@gmail.com"}],"readme":"# K-2SO\n\nBackground task agent for your desktop. K-2SO is the brains — it plans, researches, and reports. Pair it with an MCP integration pack (like [R2-D2](https://github.com/5kyguy/r2-d2)) for local system tools.\n\n**OpenCode is a prerequisite, not bundled.** Install and configure [OpenCode](https://opencode.ai) yourself (provider, auth, `~/.config/opencode/opencode.json`). K-2SO registers via sidecar files and never writes your OpenCode config.\n\n## What it does\n\n- Accept instructions via CLI (`k2so ask \"...\"`) over a Unix domain socket API\n- Run tasks in the background through an OpenCode engine\n- Persist the final answer on each done task and surface it in the dashboard Result panel, `k2so show <id>`, and `workspace/<id>/response.md`\n- Stream progress to a local web dashboard — a persistent HTTP bridge at `http://127.0.0.1:7780` (run via `k2so dashboard`, or the `k2so-dashboard.service` companion unit under R2-D2); `k2so open` opens it in your browser\n- Queue work with configurable concurrency limits; prune old workspaces with `k2so prune`\n- Remember context across tasks via local memory files (`SOUL.md`, `USER.md`, `MEMORY.md`, skills)\n\n## Requirements\n\n- Node.js 20+\n- [OpenCode](https://opencode.ai) installed and configured with your LLM provider\n- An MCP server for platform-specific tools (optional for testing)\n\n## Install\n\n```bash\n# 1. Install OpenCode and configure your provider (see docs/OPENCODE.md)\ncurl -fsSL https://opencode.ai/install | bash\n\n# 2. Install K-2SO\nnpm install -g @5kyguy/k2so\n\n# 3. Register K-2SO (markdown agent + memory seeds — no opencode.json edits)\nk2so init\n\n# 4. Run\nk2so serve\nk2so ask \"Summarize what is in my Downloads folder\"\nk2so show <task-id>   # read the answer when the task is done\n```\n\nUpgrading from the old `install.sh` model? Run `k2so init --migrate-opencode` to move the agent to `~/.config/opencode/agents/k2so.md` and remove the legacy `agent.k2so` block from your config.\n\nFull guide: [`docs/INSTALL.md`](docs/INSTALL.md). Health check: `k2so doctor`. Remove: `k2so uninstall`.\n\n## Memory\n\nK-2SO is a companion that grows via local files in `~/.config/k2so/`:\n\n- **Soul** — persona (`SOUL.md`)\n- **User** — model of you (`USER.md`)\n- **Memory** — long-term facts (`MEMORY.md`)\n- **Skills** — reusable procedures (`skills/*.md`)\n\n```bash\nk2so memory show\nk2so memory edit user\nk2so open    # open the dashboard (127.0.0.1:7780) in your browser\n```\n\nDetails: [`docs/MEMORY.md`](docs/MEMORY.md).\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnode dist/cli.js init    # or: npm link && k2so init\nk2so serve\n```\n\n## Configuration\n\nProfile path defaults to `~/.config/k2so/profile.toml`. Override with `K2SO_PROFILE`.\n\nSee [`docs/OPENCODE.md`](docs/OPENCODE.md) and `templates/` for profile and agent templates.\n\n## Changelog\n\nSee [`CHANGELOG.md`](CHANGELOG.md) or the [GitHub Releases](https://github.com/5kyguy/k-2so/releases) page.\n\n## R2-D2 integration\n\n[R2-D2](https://github.com/5kyguy/r2-d2) ships `r2d2-mcp`, Hyprland hotkeys, and voice ingress that call into K-2SO. K-2SO itself stays platform-agnostic.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}