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) orpipcmux(optional, for TUI sync)kimiCLI (optional, for ACP sessions)
Quick Start
- Configure environment variables:
cp .env.example .env
# Edit .env with your Discord token, client ID, and guild ID
- Register slash commands (once per guild):
kimi-discord-bridge deploy-commands
- 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
Release history Release notifications | RSS feed
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)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f622a12fa0a20c2c6160deb8ec2e850ee4ec71ceffa9f2a70e86fd4de2ff0004
|
|
| MD5 |
c23ea2716873a74972725b8fcf8c9c14
|
|
| BLAKE2b-256 |
8019b3742075cd7ddc360ba3ffa4fc2fd9e91433fb3881afece661398248b948
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3822e065ee9d1a6faf996b9ab5d08fcb752ae4983e760b283de434355e1f3830
|
|
| MD5 |
f8ed7e175404baacfe4f9f34942b22e6
|
|
| BLAKE2b-256 |
d12ae7d89826ef08dbd3883a2405fb134eafff0a5a2aa1cb0b5975a1348bf624
|