{
  "markdown": "# @headsdown/gemini\n\nHeadsDown availability awareness and task gating for Gemini CLI. This extension makes Gemini \"availability-aware,\" allowing it to respect your focus time, submit task proposals, and negotiate scope when you are busy.\n\n## Features\n\n- **Specialist Subagent (`@headsdown`)**: A dedicated expert agent for managing your availability, focus time, and task proposals.\n- **Interactive Conflict Resolution**: Uses Gemini CLI's native `ask_user` UI to negotiate scope (Override, Wrap-Up, or Defer) when focus conflicts arise.\n- **Real-time Gating**:\n  - `BeforeAgent` Hook: Warns the agent if you are busy or a \"Wrap-Up\" deadline is near before it even starts planning.\n  - `BeforeTool` Hook: Prevents destructive actions (file writes, shell commands) unless a proposal has been approved.\n- **Secure Storage**: Leverages Gemini CLI's `settings` to securely store your `HEADSDOWN_TOKEN` in the system keychain.\n\n## Installation\n\n### Standard Install (Recommended)\n\nInstall directly from npm:\n```bash\ngemini extension install @headsdown/gemini\n```\n\n### Local Development\n\nIf you want to contribute or run from source:\n```bash\ngit clone https://github.com/headsdownapp/headsdown-gemini.git\ncd headsdown-gemini\nnpm install\nnpm run build\ngemini extension install .\n```\n\n## Configuration\n\nAfter installation, the CLI will prompt you for your HeadsDown token. You can also set it manually:\n```bash\ngemini settings set HEADSDOWN_TOKEN <your-token>\n```\n*Tip: Use the `headsdown_auth` tool within Gemini to get your token via device flow.*\n\n## Requirements\n\n- **Node.js**: `>=22.14.0`\n- **Gemini CLI**: `v0.39.1` or higher\n\n## Development\n\n```bash\nnpm run build   # Bundle runtime entrypoints to dist/\nnpm test        # Run Vitest suite\nnpm run dev     # Watch mode\n```\n\nPublished artifacts bundle the HeadsDown SDK into `dist/index.js` and `dist/hooks/*.js` while keeping `@modelcontextprotocol/sdk` as an external runtime dependency. Source TypeScript remains in-repo for development.\n\n## Publishing\n\n1. Update version in `package.json`.\n2. Push a tag (e.g., `git tag v0.4.0 && git push origin --tags`).\n3. GitHub Actions will automatically update `CHANGELOG.md`, publish to npm, and create a GitHub Release.\n\n## Dependency update automation\n\nThis repo uses Renovate to keep `@headsdown/sdk` and other routine dependencies current. New SDK releases open bot PRs automatically, and eligible updates can automerge after required CI checks pass. In normal maintenance flow, do not manually edit `@headsdown/sdk` versions unless you are intentionally overriding Renovate behavior.\n\n## License\n\nMIT\n",
  "bytes": 2598,
  "sha": "c90dfd17ed61d4b3304126447902bfe77e459372cb0729e0dfe51ef313ab4cc2",
  "repo_slug": "headsdownapp/headsdown-gemini",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_headsdownapp_headsdown_gemini_b8508ade/readme"
}