flowmux
A Linux terminal for AI coding agents, with workspaces, notifications, and a browser agents can control.
Links
README
From the repo.
flowmux
![]()
Agent Workflow Multiplexer Terminal — Go with the agents' flow.
Website · Releases · Documentation
Run AI coding agents side by side, with terminals, browser tabs, and task notifications in one window.
Install
Ubuntu 24.04+ · amd64
curl -fsSL https://flowmux.org/install.sh | sh
flowmux fix
Open flowmux and launch your agents in terminal tabs. flowmux fix sets up
agent hooks; run it again after upgrades and restart running agent sessions.
Codex users must approve changed hooks in /hooks.
Uninstall: sudo apt remove flowmux.
Features
Agent notifications
Get desktop notifications when Claude Code, Codex, OpenCode, Gemini CLI, or Antigravity CLI finishes a task or needs input.
Browser tab
Browse alongside terminal tabs. Agents can read pages, click, and type through the CLI. Browser tabs share WebKit session data within each flowmux profile, separately from your host browsers.
Split panes and overview mode
Split and resize panes to work side by side. Use overview mode to see all active workspaces and jump between tasks.
Files, worktrees, and AI usage
Browse files, manage Git worktrees, and edit code without leaving flowmux. Check agent usage with Ctrl+Alt+U or the usage bar below the terminal.
Search terminal output
Search all terminal tabs with Ctrl+Alt+Shift+F.
Themes and keybindings
Choose a light or dark theme, customize colors and fonts, and rebind shortcuts in Options without restarting.
Image and Markdown viewers
Ctrl+click image paths to preview them inline, or open Markdown as a formatted preview. Images require ThorVG.
Agent CLI
Control browser tabs, panes, and terminals through flowmux commands.
See the CLI guide for automation and JSON output.
SSH workspaces
Work on remote hosts with the same tabs and splits. Right-click the side
panel → New SSH Workspace, or run flowmux ssh connect user@host.
Build from source
From a repository checkout:
./install.sh
See the setup guide for prerequisites, development commands, and macOS development builds.
Verify & repair
flowmux doctor # check setup
flowmux fix # repair integrations
See setup and troubleshooting for optional image/media support, hook configuration, and logs.
Documentation
- Documentation index · Release history
- Keyboard shortcuts · Configuration
- Agent CLI and browser automation · SSH workspaces
- Contributing
License
GPL-3.0-or-later · Notices. Third-party licenses and notices. Inspired by cmux; an unofficial reimplementation, not affiliated with cmux.
Collected info
- ★ 18 stars
- ⎇ 3 forks
- Language: Rust
- Source updated: 9/17/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.