{
  "markdown": "# @mukiwu/hyday-channel\n\nClaude Code channel server for [Hyday](https://hyday.web.app) — bridges note and journal events to Claude Code sessions.\n\n## What it does\n\nWhen you read a note or journal entry in Hyday for more than 30 seconds, or send a message through the buddy chat bubble, this channel server pushes the event to your Claude Code session. Claude can then:\n\n- Offer insights about the note you're reading\n- Find related past entries across your journals\n- Answer questions about your notes directly from the Hyday app\n- Generate summaries and surface forgotten connections\n\nClaude responds via the buddy chat bubble in Hyday's bottom-right corner.\n\n## Quick Start\n\n### 1. Install in your Hyday notes directory\n\n```bash\ncd <your Hyday notes directory>\nnpm install @mukiwu/hyday-channel\n```\n\n### 2. Create `.mcp.json` in your notes directory\n\n```json\n{\n  \"mcpServers\": {\n    \"hyday\": {\n      \"command\": \"npx\",\n      \"args\": [\"hyday-channel\"]\n    }\n  }\n}\n```\n\n### 3. Start Claude Code\n\n```bash\ncd <your Hyday notes directory>\nclaude --dangerously-load-development-channels server:hyday --permission-mode bypassPermissions\n```\n\nOn first run, the server automatically generates a `CLAUDE.md` file describing your notes directory structure, so Claude doesn't need to explore on every session.\n\n## Configuration\n\n| Environment Variable | Default | Description |\n|---|---|---|\n| `HYDAY_CHANNEL_PORT` | `8789` | HTTP port the channel server listens on |\n\n## Event Types\n\n| Event | Trigger | Content |\n|---|---|---|\n| `note_reading` | User reads a note for 30+ seconds | Preview of note text |\n| `journal_reading` | User reads a journal entry for 30+ seconds | Preview of journal text |\n| `user_message` | User sends a message via buddy chat bubble | The message text |\n\nEach event includes: `event_type`, `title`, `tags`, `file_id`, and a text preview (first 500 chars).\n\n## Architecture\n\n```\nHyday App  →  HTTP POST localhost:8789/event  →  hyday-channel (stdio)  →  Claude Code\nClaude Code  →  reply tool  →  hyday-channel  →  SSE localhost:8789/events  →  Hyday buddy bubble\n```\n\nThe channel server runs locally as a subprocess of Claude Code. It provides:\n\n- `POST /event` — receives events from Hyday app\n- `GET /events` — SSE stream for Claude's replies back to Hyday\n- `GET /health` — status check\n- `reply` MCP tool — Claude uses this to send messages visible in the buddy bubble\n\n## Endpoints\n\n| Method | Path | Description |\n|---|---|---|\n| `GET` | `/health` | Returns `{\"status\":\"ok\",\"server\":\"hyday\",\"version\":\"...\"}` |\n| `POST` | `/event` | Receives JSON events from Hyday app |\n| `GET` | `/events` | SSE stream of Claude's replies |\n| `OPTIONS` | `*` | CORS preflight |\n\n## Requirements\n\n- Claude Code v2.1.80 or later\n- Bun or Node.js 18+\n- Hyday desktop app\n\n## License\n\nMIT\n",
  "bytes": 2794,
  "sha": "13538f511c99bd36c55a7582a54994dc31c77c1b2366ecaed52c7524b6235033",
  "repo_slug": "mukiwu/hyday-channel",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mukiwu_hyday_channel_hyday_channel_4779b9d2/readme"
}