# modisa

> A terminal multiplexer for coding agents. Claude Code, Codex and 22 more in real panes — and you always know which one needs you.

Install on macOS or Linux with `curl -fsSL https://manyeya.github.io/modisa/install.sh | sh`, then run `modisa`. Source: https://github.com/manyeya/modisa

## Start

- [Introduction](https://manyeya.github.io/modisa/docs/introduction/): A terminal multiplexer for running many coding agents at once, and always knowing which one needs you.
- [Install](https://manyeya.github.io/modisa/docs/install/): One command on macOS and Linux. Or run it from source.
- [Quick start](https://manyeya.github.io/modisa/docs/quick-start/): Open a session, start two agents, and watch modisa tell you which one needs you.

## Using modisa

- [Keys & mouse](https://manyeya.github.io/modisa/docs/keys-and-mouse/): Every binding behind the prefix, and everything the mouse can do.
- [Spaces, tabs & panes](https://manyeya.github.io/modisa/docs/spaces-tabs-panes/): How a session is organised, and how it adapts to small terminals.
- [Sessions & remote](https://manyeya.github.io/modisa/docs/sessions/): A background server owns every pane: detach, reattach, restart, and work over ssh.
- [Settings](https://manyeya.github.io/modisa/docs/settings/): Everything modisa lets you change, searchable, from one page.
- [Make it yours](https://manyeya.github.io/modisa/docs/customize/): Themes, formats, layout, keys, commands, hooks, sounds and profiles: config.toml for everything the settings page doesn't have.

## Agents

- [Agents & detection](https://manyeya.github.io/modisa/docs/agents/): Which agents modisa knows, the states it tracks, and how it reads them.
- [Integrations](https://manyeya.github.io/modisa/docs/integrations/): Agents' own hooks and plugins: exact session resume, and exact state where the hooks see everything.
- [Agents talking to agents](https://manyeya.github.io/modisa/docs/messaging/): Send messages between agents, safely.

## Automation

- [CLI & API](https://manyeya.github.io/modisa/docs/cli/): Everything the TUI can do, as shell commands any agent can run.
- [Skill](https://manyeya.github.io/modisa/docs/skill/): A SKILL.md that teaches an agent the CLI, so it drives the session on its own.
- [Plugins](https://manyeya.github.io/modisa/docs/plugins/): Programs started with each session: actions, panes, keys, links, and a little of the TUI.

## Reference

- [Configuration](https://manyeya.github.io/modisa/docs/config/): config.toml, with every setting and its default.
- [Updating](https://manyeya.github.io/modisa/docs/updating/): Releases, the update badge, and the staging channel.
- [Troubleshooting](https://manyeya.github.io/modisa/docs/troubleshooting/): When something doesn't look right.

## Optional

- [Everything above in one file](https://manyeya.github.io/modisa/llms-full.txt): all of the docs as markdown
- [Plugins](https://manyeya.github.io/modisa/plugins/): the community plugin directory
- [Releases](https://github.com/manyeya/modisa/releases): binaries, checksums and packages