Skip to main content

Discord bridge for Kimi CLI with cmux integration

Project description

kimi-discord-bridge

Discord bridge for Kimi CLI with cmux integration.

Run Kimi sessions inside Discord threads while simultaneously driving a toad TUI in a cmux pane — both views stay in sync.

Installation

uv tool install --python 3.14 kimi-discord-bridge

Or install from source:

git clone https://github.com/yourusername/kimi-discord-bridge.git
cd kimi-discord-bridge
uv tool install --python 3.14 .

Requirements

  • Python 3.14+
  • uv (recommended) or pip
  • cmux (optional, for TUI sync)
  • kimi CLI (optional, for ACP sessions)

Quick Start

  1. Configure environment variables:
cp .env.example .env
# Edit .env with your Discord token, client ID, and guild ID
  1. Register slash commands (once per guild):
kimi-discord-bridge deploy-commands
  1. Run the bot:
kimi-discord-bridge run

Commands

Command Description
/new Create a new Kimi session (workspace select → name)
/list List active sessions
/status <name> Check session status
/close [name] Close a session
/steer <name> <message> Send follow-up message
/interrupt <name> Interrupt active turn
/peek <name> [lines] Preview cmux screen

Architecture

Discord Thread  <--->  Bot (discord.py)  <--->  AcpMux  <--->  kimi acp
                                               ^
                                               |
cmux pane  <--->  toad TUI  <--->  attach (unix socket)

License

MIT

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

kimi_discord_bridge-0.1.0.tar.gz (96.0 kB view details)

Uploaded Source

Built Distribution

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

kimi_discord_bridge-0.1.0-py3-none-any.whl (32.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kimi_discord_bridge-0.1.0.tar.gz
  • Upload date:
  • Size: 96.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","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 kimi_discord_bridge-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f622a12fa0a20c2c6160deb8ec2e850ee4ec71ceffa9f2a70e86fd4de2ff0004
MD5 c23ea2716873a74972725b8fcf8c9c14
BLAKE2b-256 8019b3742075cd7ddc360ba3ffa4fc2fd9e91433fb3881afece661398248b948

See more details on using hashes here.

File details

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

File metadata

  • Download URL: kimi_discord_bridge-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 32.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","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 kimi_discord_bridge-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3822e065ee9d1a6faf996b9ab5d08fcb752ae4983e760b283de434355e1f3830
MD5 f8ed7e175404baacfe4f9f34942b22e6
BLAKE2b-256 d12ae7d89826ef08dbd3883a2405fb134eafff0a5a2aa1cb0b5975a1348bf624

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