Skip to main content

Cross-session real-time chat MCP server for Claude Code — channels-based daemon push, sub-2s latency, group + handshake. Part of the khimaira workspace.

Project description

khimaira-chat

Cross-session real-time chat MCP server for Claude Code. Daemon-push via claude/channel capability; sub-2s end-to-end latency.

Part of the khimaira workspace.

What it does

  • Lets two or more Claude Code sessions hold a real-time chat conversation.
  • Messages land in the recipient's context as <channel source="khimaira-chat" ...> blocks via Claude Code's channels feature.
  • Groups + handshake — N-session rooms, all members must accept the invite before they receive messages.
  • State (rooms, members, transcripts) lives in the khimaira-monitor daemon; this MCP server is a per-session stdio subprocess that subscribes to its session's events and forwards them to the agent.

Architecture

See tasks/khimaira-chat/IMPLEMENTATION.md in the workspace root for the full design.

Claude Code session  ◄── stdio ──►  khimaira-chat MCP subprocess  ◄── HTTP/SSE ──►  khimaira-monitor daemon

Install (per Claude Code peer)

khimaira sync registers this MCP server in your Claude Code config. To launch with channels enabled (research preview):

claude --dangerously-load-development-channels server:khimaira-chat

Slash commands

  • /khimaira-chat <peers...> — create + invite (or resume if same members already have a chat)
  • /khimaira-chat-accept <chat_id> — accept an invite
  • /khimaira-chat-send <chat_id> <body> — send a message
  • /khimaira-chat-history <chat_id> — read transcript
  • /khimaira-chat-list — your active chats
  • /khimaira-chat-leave <chat_id> — leave a chat
  • /khimaira-chat-delete <chat_id> — archive a chat (creator only)
  • /khimaira-chat-poll <chat_id> — manual catch-up (escape hatch when channels misbehave)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

khimaira_chat-0.1.0.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

khimaira_chat-0.1.0-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

File details

Details for the file khimaira_chat-0.1.0.tar.gz.

File metadata

  • Download URL: khimaira_chat-0.1.0.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for khimaira_chat-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7d9d20cdaafa83de98e1d4b68937417790de406cf076426dfc051a861ab9e265
MD5 3917ea85e463d505ff8566081a95d551
BLAKE2b-256 0b001fba68bbeab317daba5524d01060328bb1b171f515871fc0e491d9449715

See more details on using hashes here.

File details

Details for the file khimaira_chat-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: khimaira_chat-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for khimaira_chat-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5b43c268d33416e6019753fa11956c21d41f3db9214c17d612aa2dfcd46d667d
MD5 f0e3e2a08b49f82a563d480e6d6d857d
BLAKE2b-256 d948708617dd032172c877c492b2f9b4a1ea23100dfbb9a0351329119ef70fda

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page