{"_id":"@calvin.magezi/agent-hq","_rev":"6-fecfc00937bad2ebb7781831128e63cc","name":"@calvin.magezi/agent-hq","dist-tags":{"latest":"0.6.8"},"versions":{"0.1.0":{"name":"@calvin.magezi/agent-hq","version":"0.1.0","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"license":"MIT","_id":"@calvin.magezi/agent-hq@0.1.0","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"homepage":"https://github.com/CalvinMagezi/agent-hq","bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"bin":{"hq":"bin/hq"},"dist":{"shasum":"a26f682034c74521e40c310ef751cbbb6e547615","tarball":"https://registry.npmjs.org/@calvin.magezi/agent-hq/-/agent-hq-0.1.0.tgz","fileCount":3,"integrity":"sha512-Yb7t+1wSPcEdcci2frsf7cVSjJ6qGPJwKWXwLX5y4cQ8+xNgNTIXi0jcBFcY53k5ryXtiwKM02gvNP28ELDyMA==","signatures":[{"sig":"MEUCIDDdFIRV3Z7vCT9jOcjwfxJLkvtCt0TAjfeahBvVRKUPAiEA/sx8uGBJtJWjuumiqCspTllGXY8IMO+dahpwy6Ae+bw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5812},"engines":{"bun":">=1.1.0"},"gitHead":"43df0c751d94bf86cdbb3c20c05011961a37cc2b","scripts":{"prepublishOnly":"echo 'Publishing hq CLI...'"},"_npmUser":{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"},"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"_npmVersion":"11.9.0","description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","directories":{},"_nodeVersion":"25.6.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-hq_0.1.0_1772286751148_0.4576885072712287","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"0.3.0":{"name":"@calvin.magezi/agent-hq","version":"0.3.0","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"license":"MIT","_id":"@calvin.magezi/agent-hq@0.3.0","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"homepage":"https://github.com/CalvinMagezi/agent-hq","bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"bin":{"hq":"bin/hq"},"dist":{"shasum":"718ff4fb83afe5a1f7be46f2c071584cbf306908","tarball":"https://registry.npmjs.org/@calvin.magezi/agent-hq/-/agent-hq-0.3.0.tgz","fileCount":6,"integrity":"sha512-HDtxX6RYD81uIlQb3YNhKzuXc/HHzvoHYAqykjrVITO7d39bjKjXoc0pj1t8dKp4sW+5oeIegffjFHh+q+NekQ==","signatures":[{"sig":"MEQCIDeiayArn37jAewxnvVou+7x58Lp95K//1SpQMexlmbPAiBlafL0tX7hTOtBU6XA/UC4VZVqX+mX003F0iAjd3PUzA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20802},"engines":{"bun":">=1.1.0"},"gitHead":"8ce26d575b068ba7bc29af2ecd9dcac108534af6","scripts":{"prepublishOnly":"echo 'Publishing hq CLI...'"},"_npmUser":{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"},"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"_npmVersion":"10.8.2","description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-hq_0.3.0_1773117726876_0.904260122861672","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"0.5.0":{"name":"@calvin.magezi/agent-hq","version":"0.5.0","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"license":"MIT","_id":"@calvin.magezi/agent-hq@0.5.0","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"homepage":"https://github.com/CalvinMagezi/agent-hq","bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"bin":{"hq":"bin/hq"},"dist":{"shasum":"c5450b86322742c371cf67202a67ae4b2fd50a87","tarball":"https://registry.npmjs.org/@calvin.magezi/agent-hq/-/agent-hq-0.5.0.tgz","fileCount":6,"integrity":"sha512-6eylZcXd2DsvBejw51WaFF6O1mC6SFTPPXcbTYHrG19jY930/81rSYg4DzJHGDM5lkYtZNwza37vHhfNmJKL4w==","signatures":[{"sig":"MEQCIG6RQaEu2Nm3ufF8UK8Cnd8I7sTonFeYAAAUxyz1BOLyAiBBJcDe9/Ug6NYOvg0AZIyVrrgoKKsWKoMFXE15qaB6Aw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20812},"engines":{"bun":">=1.1.0"},"gitHead":"12b58ef83255a267f04a6eed60e3b7dfdd4365c8","scripts":{"prepublishOnly":"echo 'Publishing hq CLI...'"},"_npmUser":{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"},"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"_npmVersion":"10.8.2","description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-hq_0.5.0_1773201022326_0.23067068576373195","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"0.6.4":{"name":"@calvin.magezi/agent-hq","version":"0.6.4","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"license":"MIT","_id":"@calvin.magezi/agent-hq@0.6.4","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"homepage":"https://github.com/CalvinMagezi/agent-hq","bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"bin":{"hq":"bin/hq"},"dist":{"shasum":"7557c734051560a030ad8479a551e8ba0da8499e","tarball":"https://registry.npmjs.org/@calvin.magezi/agent-hq/-/agent-hq-0.6.4.tgz","fileCount":6,"integrity":"sha512-79dkHwgOPQxJPGC3oth8onY826jExg0G6On6FEbsqCfrZY+Hp0jk+0MwMzOfiOdU2F2oCKDN5bki87LS73OGfg==","signatures":[{"sig":"MEUCIQD6FGvSw5tAGu/t5VyF7AiQb0dixl+sV4gOjtzCMR4XmAIgFqZpTRabCBYmSoUyjqQELZbAT3j7rEZqYQIHhv6RUK8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23268},"engines":{"node":">=18.0.0"},"gitHead":"60949fb731a473dd56d52e7da3272f43873fc996","scripts":{"prepublishOnly":"echo 'Publishing hq CLI...'"},"_npmUser":{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"},"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"_npmVersion":"10.8.2","description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-hq_0.6.4_1773400848279_0.06319228831720336","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"0.6.8":{"name":"@calvin.magezi/agent-hq","version":"0.6.8","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"license":"MIT","_id":"@calvin.magezi/agent-hq@0.6.8","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"homepage":"https://github.com/CalvinMagezi/agent-hq","bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"bin":{"hq":"bin/hq"},"dist":{"shasum":"082bc701a179e22482af85541855c87d1d3af5dc","tarball":"https://registry.npmjs.org/@calvin.magezi/agent-hq/-/agent-hq-0.6.8.tgz","fileCount":6,"integrity":"sha512-sdNGAr+MqR7FBwcOr+CBgVsedBtuyR7k//Ed3mzrbi0Kk+O7Jlrw2SXSrAVlh60SCtL7TE66bvqo1wEvEN1OrQ==","signatures":[{"sig":"MEUCIFEl5kk7ou2qtpbISyzxUJvajVb85aD2uGpWh54x6LxPAiEAzJMILwD9HdqaSRnk1aUyu9pq0V82vWQ5eINS1O6SrSI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24009},"engines":{"bun":">=1.1.0","node":">=18.0.0"},"gitHead":"f0f57fa4cd5f2c7f52b2e029ebd47ab203d441f1","scripts":{"prepublishOnly":"echo 'Publishing hq CLI...'"},"_npmUser":{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"},"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"_npmVersion":"10.8.2","description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","directories":{},"_nodeVersion":"20.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-hq_0.6.8_1773674834745_0.7234214768375766","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2026-02-28T13:52:31.070Z","modified":"2026-03-21T07:31:30.612Z","0.1.0":"2026-02-28T13:52:31.305Z","0.3.0":"2026-03-10T04:42:07.036Z","0.5.0":"2026-03-11T03:50:22.467Z","0.6.4":"2026-03-13T11:20:48.420Z","0.6.8":"2026-03-16T15:27:14.881Z"},"bugs":{"url":"https://github.com/CalvinMagezi/agent-hq/issues"},"license":"MIT","homepage":"https://github.com/CalvinMagezi/agent-hq","keywords":["ai","agent","claude","gemini","discord","local-first","obsidian"],"repository":{"url":"git+https://github.com/CalvinMagezi/agent-hq.git","type":"git","directory":"packages/hq-cli"},"description":"HQ CLI — local-first AI agent hub for Claude, Gemini & Discord","maintainers":[{"name":"calvin.magezi","email":"calvin.m.magezi@gmail.com"}],"readme":"# agent-hq CLI\n\n> Local-first AI agent hub — Claude, Gemini & Discord, all from one command.\n\n## Quick Install\n\n```bash\n# Zero-install (auto-clones repo, installs Bun if needed)\nnpx @calvin.magezi/agent-hq\n\n# Or with Bun (faster):\nbunx @calvin.magezi/agent-hq\n```\n\nThis will:\n1. Install Bun if not present\n2. Clone the agent-hq repo to `~/agent-hq`\n3. Run `hq init` to set up everything\n\n## From Source\n\n```bash\ngit clone https://github.com/CalvinMagezi/agent-hq.git\ncd agent-hq\nbun install\nbun scripts/hq.ts init\n```\n\n## First-Time Setup\n\nAfter installation, run the guided walkthrough:\n\n```bash\nhq quickstart\n```\n\nOr set up step by step:\n\n```bash\nhq init                  # Full setup (vault, tools, services)\nhq env                   # Configure API keys interactively\nhq doctor                # Verify everything works\n```\n\n### API Keys\n\nYou need at least one of these to use AI chat:\n\n| Key | Where to get it | Required? |\n|-----|-----------------|-----------|\n| `OPENROUTER_API_KEY` | [openrouter.ai/keys](https://openrouter.ai/keys) | Yes (or Gemini) |\n| `GEMINI_API_KEY` | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) | Optional |\n| `DISCORD_BOT_TOKEN` | [discord.com/developers](https://discord.com/developers/applications) | Optional |\n\nRun `hq env` to set these interactively.\n\n## Essential Commands\n\n| Command | Description |\n|---------|-------------|\n| `hq` | Start chatting (default) |\n| `hq quickstart` | Guided first-run walkthrough |\n| `hq doctor` | Diagnose common issues |\n| `hq env` | Set up API keys |\n| `hq status` | Check what's running |\n| `hq start all` | Start all services |\n| `hq stop all` | Stop all services |\n| `hq pwa` | Open the web dashboard |\n| `hq vault open` | Open vault in Obsidian |\n| `hq health` | Full health check |\n| `hq logs [target]` | View logs |\n| `hq help` | Essential commands |\n| `hq help --all` | All commands |\n| `hq help --agent` | Quick reference for AI agents |\n\n## For AI Agents\n\nThe CLI is fully automatable:\n\n```bash\nOPENROUTER_API_KEY=sk-or-... \\\n  npx @calvin.magezi/agent-hq init --non-interactive\n```\n\nRun `hq help --agent` for the recommended command sequence.\n\n## What's Included\n\n- **Vault**: An Obsidian-compatible folder of markdown files — your AI's knowledge base\n- **HQ Agent**: Background worker that processes AI jobs\n- **Discord Relay**: Multi-bot system for chatting via Discord\n- **Web Dashboard**: PWA on localhost:4747 for monitoring\n- **Terminal Chat**: `hq` starts an interactive REPL\n- **Daemon**: Background workflows (memory consolidation, web digests, etc.)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}