devmux

tmux-based service management for monorepos.
Shared awareness between human developers and AI agents.

$ npm install -g @chriscode/devmux

The Problem

Human: pnpm dev → Server running on port 8787
Agent: pnpm dev → Port conflict! Or kills your server!

When humans and AI agents work in the same codebase, they step on each other. Agents restart servers you're using. You lose state when agents kill processes. There's no shared awareness.

The Solution

Human: devmux run --with api -- pnpm ios
Agent: devmux ensure api → "✅ Already running"

devmux uses tmux sessions with predictable names as a shared registry. Both humans and agents can see what's running and reuse existing services.

Quick Start

# Install
npm install -g @chriscode/devmux

# Create config
devmux init > devmux.config.json

# Use it
devmux ensure api           # Idempotent start
devmux status               # See what's running
devmux run --with api -- pnpm ios  # Run with cleanup

Features

🔄

Idempotent Operations

devmux ensure api is always safe to call. Running? Reuse. Stopped? Start.

👁️

Shared Visibility

Both human and agent can see what's running via tmux sessions with predictable names.

🧹

Smart Cleanup

Ctrl+C cleans up services you started, but not the agent's. No more stepping on each other.

❤️

Health-First

Checks if services are actually healthy, not just if a process exists.

Works With

OpenCode, Claude Code, Cursor, and any AI assistant that can run terminal commands. Uses the omo-{project}-{service} naming convention for discoverability.