hyday-channel
Claude Code channel server for Hyday — bridges note and journal events to Claude Code sessions.
Open source Repository Open in the app JSON README (API)
About
Claude Code channel server for Hyday — bridges note and journal events to Claude Code sessions.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- mukiwu
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-06T10:55:35Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
mukiwu/hyday-channel/hyday-channel
README
# @mukiwu/hyday-channel
Claude Code channel server for [Hyday](https://hyday.web.app) — bridges note and journal events to Claude Code sessions.
## What it does
When 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:
- Offer insights about the note you're reading
- Find related past entries across your journals
- Answer questions about your notes directly from the Hyday app
- Generate summaries and surface forgotten connections
Claude responds via the buddy chat bubble in Hyday's bottom-right corner.
## Quick Start
### 1. Install in your Hyday notes directory
```bash
cd <your Hyday notes directory>
npm install @mukiwu/hyday-channel
```
### 2. Create `.mcp.json` in your notes directory
```json
{
"mcpServers": {
"hyday": {
"command": "npx",
"args": ["hyday-channel"]
}
}
}
```
### 3. Start Claude Code
```bash
cd <your Hyday notes directory>
claude --dangerously-load-development-channels server:hyday --permission-mode bypassPermissions
```
On 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.
## Configuration
| Environment Variable | Default | Description |
|---|---|---|
| `HYDAY_CHANNEL_PORT` | `8789` | HTTP port the channel server listens on |
## Event Types
| Event | Trigger | Content |
|---|---|---|
| `note_reading` | User reads a note for 30+ seconds | Preview of note text |
| `journal_reading` | User reads a journal entry for 30+ seconds | Preview of journal text |
| `user_message` | User sends a message via buddy chat bubble | The message text |
Each event includes: `event_type`, `title`, `tags`, `file_id`, and a text preview (first 500 chars).
## Architecture
```
Hyday App → HTTP POST localhost:8789/event → hyday-channel (stdio) → Claude Code
Claude Code → reply tool → hyday-channel → SSE localhost:8789/events → Hyday buddy bubble
```
The channel server runs locally as a subprocess of Claude Code. It provides:
- `POST /event` — receives events from Hyday app
- `GET /events` — SSE stream for Claude's replies back to Hyday
- `GET /health` — status check
- `reply` MCP tool — Claude uses this to send messages visible in the buddy bubble
## Endpoints
| Method | Path | Description |
|---|---|---|
| `GET` | `/health` | Returns `{"status":"ok","server":"hyday","version":"..."}` |
| `POST` | `/event` | Receives JSON events from Hyday app |
| `GET` | `/events` | SSE stream of Claude's replies |
| `OPTIONS` | `*` | CORS preflight |
## Requirements
- Claude Code v2.1.80 or later
- Bun or Node.js 18+
- Hyday desktop app
## License
MIT