Documentation

Quick start

From install to your first multi-agent layout in three steps.

1. Install
Run the command for your platform from Install. There is no config file to write — the app creates its own on first run.
```
curl -fsSL https://bentomux.takora.dev/install.sh | sh
```
2. Add a workspace
Launch the app and add a folder — a project directory. Its terminal opens in the working directory you chose, and the sidebar remembers it. Add as many workspaces as you are working in.
Split with Cmd/Ctrl + \, drag the borders, and rename tabs from the UI. The command palette is Cmd/Ctrl + K if you would rather not use the mouse.
3. Run your agents
In each pane, start whichever agent you want — Claude Code, Codex CLI, pi, or any shell tool. Bentomux labels the pane once it recognises the agent.
```
claude  # in pane 1 
codex   # in pane 2
```
Switch panes freely — the shells keep running. Quit the app and come back: your agents are still there. That part is covered in Sessions and panes.

1. Install