convez.ai
MCP Server
slaser79

hitl-channel

slaser79/hitl-channel

Ver no GitHub
InicialPluginScore · de 0 a 100

HITL Channel - Claude Code MCP channel plugin for direct mobile-to-agent communication. Privacy-first, no intermediary.

Instalação

$npx convez-ai slaser79/hitl-channel

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
1
Contribuidores
3

README

A tradução para o português deste README ainda está na fila.

hitl-channel

Claude Code MCP channel plugin for direct mobile-to-agent communication.

hitl-channel is a TypeScript MCP server that enables bidirectional communication between the HITL mobile app and Claude Code sessions — with no cloud intermediary. Messages travel directly over your LAN or Tailscale network.

Features

  • Privacy-first: Direct LAN/Tailscale connection, no relay server
  • Claude Code Channels: Native MCP channel protocol (notifications/claude/channel)
  • Pairing flow: Secure 6-digit code pairing with device token allowlist
  • mDNS discovery: Auto-discovery on local network (_hitl-channel._tcp)
  • WebSocket bridge: Real-time bidirectional messaging
  • Multi-instance: Support multiple Claude Code sessions with distinct identities

Quick Start

Prerequisites

  • Bun (recommended) or Node.js 20+
  • Claude Code v2.1.80+ (channels require research preview)

Install

# Clone
git clone https://github.com/slaser79/hitl-channel.git
cd hitl-channel
bun install

Configure Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "hitl-channel": {
      "command": "bun",
      "args": ["run", "/path/to/hitl-channel/src/server.ts"],
      "env": {
        "HITL_CHANNEL_PORT": "8789"
      }
    }
  }
}

Start Claude Code with Channels

claude --dangerously-load-development-channels server:hitl-channel

Connect from HITL App

  1. Open HITL app on your phone
  2. Go to Agents > Claude Code > Add Instance
  3. Enter your machine's IP and port 8789 (or discover via mDNS on same network)
  4. Tap "Pair" — a 6-digit code will appear in your Claude Code session
  5. Enter the code in the app
  6. Start chatting!

Architecture

hitl-app (phone)
    │
    ├── HTTP POST /           → Send messages to Claude Code
    ├── POST /pair/request    → Initiate pairing (code sent via channel notification)
    ├── POST /pair/validate   → Validate code, receive device token
    └── WebSocket /ws         → Receive replies from Claude Code
          │
          ▼
hitl-channel (MCP server, port 8789)
    │
    ├── channel notification  → Push messages into Claude Code session
    └── reply_to_hitl tool    → Claude Code sends replies back
          │
          ▼
Claude Code (your terminal)

Environment Variables

VariableDefaultDescription
HITL_CHANNEL_PORT8789HTTP/WebSocket bridge port
HITL_CHANNEL_API_KEY(none)Legacy API key auth (optional)

Data Storage

Identity and allowlist are stored in ~/.hitl/channels/:

  • identity.json — Instance ID (stable across restarts)
  • allowlist.json — Paired device token hashes (SHA-256)

API Endpoints

EndpointMethodAuthDescription
/healthGETNoHealth check (status, port, client count)
/instanceGETNoInstance identity (instanceId, hostname)
/pair/requestPOSTNoRequest pairing code (sent to Claude Code via channel)
/pair/validatePOSTNoValidate code, returns device token
/POSTYesSend message to Claude Code
/wsGETYesWebSocket for receiving replies

Development

# Run tests
bun test

# Start standalone (for development)
bun src/server.ts

Related Projects

  • hitl-cli — Python CLI/SDK for relay-based HITL (via hitlrelay.app)
  • hitl-app — HITL mobile app (iOS/Android)

License

MIT

Ver o original no GitHub

Bom para

Relacionados