Automation & Integration

Mosaic is fully programmable. Beyond the graphical interface, it provides three complementary interfaces for automation, scripting, and AI agent integration.

HTTP API

A local REST API gives you programmatic control over every aspect of Mosaic. Anything you can do in the UI -- managing panes, workspaces, contexts, agent teams, layouts, and more -- can also be done through API calls.

The API only listens on your local machine and is not exposed to the network by default. You can enable remote access in Settings if needed.

What you can automate:

• Open, close, split, rename, and read terminal panes
• Create and switch workspaces and contexts
• Spawn and coordinate agent teams
• Export and import layouts
• Trigger keyboard shortcuts programmatically
• Monitor CI status and fetch failure logs
• Access debugging and diagnostic information

CLI

Mosaic ships with a command-line tool that wraps the HTTP API into simple commands. It requires no installation beyond Node.js and provides quick access to all major features from any terminal.

Common uses:

• List and manage panes, workspaces, and contexts
• Send commands to terminals and read their output
• Export and import layouts
• Take screenshots
• View application logs and diagnostics

MCP Server

Mosaic includes a Model Context Protocol (MCP) server, enabling AI coding agents to interact with Mosaic as a tool provider. Agents can discover their own identity, read terminal output, run commands, manage workspaces, coordinate with other agents, and much more -- all through the standard MCP interface.

What agents can do through MCP:

• Discover their own pane and context (self-awareness)
• Read and write to terminals
• Manage workspaces, contexts, and layouts
• Coordinate as agent teams with messaging
• Interact with the project board, roadmap, and scheduler
• Use language servers for code intelligence
• Launch and control debugging sessions
• Record and capture terminal output

Mosaic automatically configures MCP access for supported coding agents when they are spawned, so agents can start using these capabilities immediately without manual setup.

Related

• Agent Orchestration -- how agents coordinate through Mosaic
• Settings -- remote access configuration
• Getting Started -- initial setup