Metadata-Version: 2.4
Name: controlmesh
Version: 0.42.0a1
Summary: ControlMesh brings official coding CLIs into Telegram, Matrix, and Feishu with persistent workspaces, long-running jobs, and production-friendly bot operations.
Project-URL: Homepage, https://github.com/muqiao215/ControlMesh
Project-URL: Repository, https://github.com/muqiao215/ControlMesh
Project-URL: Documentation, https://github.com/muqiao215/ControlMesh
Project-URL: Issues, https://github.com/muqiao215/ControlMesh/issues
Project-URL: Changelog, https://github.com/muqiao215/ControlMesh/releases
Author: muqiao215
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,automation,bot,claude,cli,codex,controlmesh,streaming,telegram
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: aiogram<4.0.0,>=3.24.0
Requires-Dist: aiohttp-socks<0.11.0,>=0.10.1
Requires-Dist: aiohttp<4.0.0,>=3.9.0
Requires-Dist: cronsim>=2.7
Requires-Dist: filetype>=1.2.0
Requires-Dist: lark-oapi>=1.5.5
Requires-Dist: pillow>=10.0.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: questionary>=2.1.1
Requires-Dist: requests>=2.32.0
Requires-Dist: rich>=14.3.2
Requires-Dist: tzdata>=2024.1
Provides-Extra: api
Requires-Dist: pynacl>=1.6.2; extra == 'api'
Provides-Extra: dev
Requires-Dist: matrix-nio>=0.25.0; extra == 'dev'
Requires-Dist: mypy>=1.19.1; extra == 'dev'
Requires-Dist: pynacl>=1.6.2; extra == 'dev'
Requires-Dist: pytest-aiohttp>=1.1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
Requires-Dist: pytest>=9.0.2; extra == 'dev'
Requires-Dist: ruff>=0.15.0; extra == 'dev'
Requires-Dist: time-machine>=3.2.0; extra == 'dev'
Provides-Extra: lint
Requires-Dist: mypy>=1.19.1; extra == 'lint'
Requires-Dist: ruff>=0.15.0; extra == 'lint'
Provides-Extra: matrix
Requires-Dist: matrix-nio>=0.25.0; extra == 'matrix'
Provides-Extra: openai-agents
Requires-Dist: openai-agents; extra == 'openai-agents'
Provides-Extra: test
Requires-Dist: pytest-aiohttp>=1.1.0; extra == 'test'
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'test'
Requires-Dist: pytest-cov>=7.0.0; extra == 'test'
Requires-Dist: pytest>=9.0.2; extra == 'test'
Requires-Dist: time-machine>=3.2.0; extra == 'test'
Description-Content-Type: text/markdown

# 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:

```bash
pipx install controlmesh
controlmesh
```

`controlmesh` opens the enhanced terminal. Use `/cm` for provider-native mode and `/back`
to return. Start the legacy messaging runtime with:

```bash
controlmesh bot
```

Develop from source:

```bash
git clone https://github.com/muqiao215/ControlMesh.git
cd ControlMesh
uv sync --locked --all-extras --dev
uv run controlmesh
```

Verify the toolchain:

```bash
python scripts/doctor_toolchain.py --strict --require-bun
```

Evaluate the read-only Alpha from an isolated install:

```bash
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](docs/read-only-alpha.md) for the complete five-minute flow.

## Documentation

- [Project Context](PROJECT.md)
- [Architecture](docs/ARCHITECTURE.md)
- [Decisions](docs/DECISIONS.md)
- [Installation](docs/installation.md)
- [Read-only Alpha](docs/read-only-alpha.md)
- [Feishu Setup](docs/feishu-setup.md)
- [Telegram Setup](docs/telegram-setup.md)
- [WeChat Setup](docs/weixin-setup.md)
- [Enhanced Terminal](docs/terminal.md)
- [Full Documentation Index](docs/README.md)

Contributors and coding agents should begin with [AGENTS.md](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](LICENSE).
