ModelMesh

ModelMesh is a Textual-based terminal UI for running and switching between multiple coding-agent CLIs from one project workspace.

It currently supports:

• Claude Code
• Codex
• Gemini CLI
• Open Code
• OpenClaw

Each agent gets its own session state, and the active agent can be started, stopped, restarted, and interacted with directly from the TUI.

What It Does

• Shows a left sidebar with available agents and live session-state badges
• Lets you switch the active agent without leaving the app
• Starts each agent inside a PTY so terminal-style output is preserved
• Forwards keyboard input to a running agent session
• Keeps a shared project root visible in the UI
• Persists the selected agent and project root in a config file
• Provides a built-in config editor for command overrides
• Uses writable runtime directories for agents that need local state isolation

Install

uv sync
uv run modelmesh

The package also exposes a console entrypoint:

modelmesh
mesh

Requirements

• Python 3.12+
• One or more supported agent CLIs installed and available on PATH

ModelMesh does not install agent CLIs for you.

Supported Agents

If a binary is not found on PATH, ModelMesh will show a system message instead of starting that session.

Keyboard Shortcuts

When an agent session is running, regular keys and common control/navigation keys are forwarded into the active PTY session.

Configuration

ModelMesh stores configuration at:

~/.config/modelmesh/config.toml

If platformdirs is available, the config path is resolved through that library. Otherwise it falls back to ~/.config/modelmesh/config.toml.

Example:

active_agent = "codex"
project_root = "/path/to/project"
terminal_bottom_height = 9

[agent_overrides]
claude = ["claude", "--dangerously-skip-permissions"]
codex = ["codex", "--help"]

agent_overrides lets you replace the default command used for a specific agent.

Runtime Behavior

• Sessions are managed per agent, so switching agents does not destroy another agent's session
• Agent processes are launched in the selected project root
• Output is rendered through pyte, then displayed in the Textual UI
• Stopping a session sends SIGTERM first, then escalates to SIGKILL if needed
• Some agent-local runtime files are written under .modelmesh-runtime/ in the current working directory

Development

Run tests with:

uv run pytest

Current test coverage includes:

• config load/save behavior
• adapter registry and binary detection
• session lifecycle basics
• terminal rendering helpers
• smoke coverage for app construction

Screenshots

Codex

Open Code

Claude Code