ControlMesh
ControlMesh is a local-first, chat-native task runtime for official coding CLIs. It connects Claude, Codex, Gemini, OpenCode, and configured providers to persistent workspaces, background tasks, multi-agent coordination, messaging transports, and operational tools.
What
ControlMesh lets you:
- work interactively in an enhanced local terminal;
- run the legacy bot runtime through Feishu, Telegram, WeChat, Matrix, and compatible transports;
- create persistent background tasks that can ask for input, resume, recover, and deliver results;
- coordinate bounded multi-agent topologies on a shared Python runtime;
- inspect tasks, providers, events, topologies, and artifacts through a local read-only Web dashboard.
Python remains the authoritative runtime. The TypeScript workspace provides public protocol models, runtime validation, an SDK, and the local dashboard.
Quick Start
Install the released CLI:
pipx install controlmesh
controlmesh
controlmesh opens the enhanced terminal. Use /cm for provider-native mode and /back
to return. Source installs also provide cm as a shell-command alias for controlmesh
(including cm --help and cm --version); older releases may only provide controlmesh.
Start the legacy messaging runtime with:
controlmesh bot
Develop from source:
git clone https://github.com/muqiao215/ControlMesh.git
cd ControlMesh
uv sync --locked --all-extras --dev
uv run controlmesh
Verify the toolchain:
python scripts/doctor_toolchain.py --strict --require-bun
Evaluate the read-only Alpha from an isolated install:
pipx install --suffix=-alpha "controlmesh[api]==0.42.0a1"
controlmesh-alpha api serve
Open the printed local dashboard URL and enter the printed bearer token. The Alpha server
binds only to 127.0.0.1 and exposes read-only /api/v1 routes; see the
read-only Alpha guide for the complete five-minute flow.
Documentation
- Project Context
- Architecture
- Decisions
- Installation
- Read-only Alpha
- Feishu Setup
- Telegram Setup
- WeChat Setup
- Enhanced Terminal
- Full Documentation Index
Contributors and coding agents should begin with AGENTS.md.
Status
The Python terminal, bot, task, provider, memory, transport, and multi-agent runtime is the
stable core. The authenticated /api/v1 facade, TypeScript SDK, and local Web dashboard are
an additive read-only product layer. TypeScript task mutation and runtime replacement remain
blocked until Python golden parity and rollback gates exist.
License
MIT. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for controlmesh 0.42.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| controlmesh-0.42.1.tar.gz | 2.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| controlmesh-0.42.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.4 MB
Release files / controlmesh-0.42.1.tar.gz
| Download URL | controlmesh-0.42.1.tar.gz |
|---|---|
| Size | 2.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a50c66fad66fd8c4fb0f1198431fd77d1cd184631503cb296f88faa7c7dcd3b7
|
|
BLAKE2b-256 checksum How to use checksums |
272b7f8c8e25468cbfd34f470657796cf828204fa5d93c85e09d567231949131
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency logRelease files / controlmesh-0.42.1-py3-none-any.whl
| Download URL | controlmesh-0.42.1-py3-none-any.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
83a0d2130d2832f8d404ea54bf32c24038376cb974225e67b3ea18c54e262406
|
|
BLAKE2b-256 checksum How to use checksums |
0d53faccb5d557c3025d0672ac510373c1ee082f95020e4e708fddb66a7e47f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency log
