terminal
mdocker terminal manages per-project tmux sessions. Session state lives under
.projects[<name>].sessions[] in the registry; tmux sessions are named
mdocker__<project>__<id>. See AI Terminal Sessions.
terminal new
Section titled “terminal new”Create a new session.
mdocker terminal new <name> --tool <claude|copilot|shell> [--sandbox | --no-sandbox]--sandbox maps to Claude Code’s --sandbox flag; it is ignored for copilot (no
sandbox flag today).
terminal list
Section titled “terminal list”List sessions (alive computed live).
mdocker terminal list <name>mdocker terminal list <name> --jsonmdocker terminal list --all # every project in one call--all returns [{ project, sessions: [...] }] for every registry project that has
sessions; projects without sessions are skipped. The macOS app issues exactly this one
call per polling tick.
Every living session carries three extra fields read from tmux:
| Field | Source | Meaning |
|---|---|---|
activity |
#{window_activity} |
Epoch of the last pane activity (null if unreadable). |
exited |
#{pane_dead} |
true once the pane’s process has ended. |
title |
#{pane_title} |
Title set by the program via OSC 0/2; null when empty or just the hostname default. |
Sessions are created with the tmux options status off (no status bar) and
set-titles on.
terminal kill
Section titled “terminal kill”End a session.
mdocker terminal kill <name> <session-id>terminal prune
Section titled “terminal prune”Drop registry entries whose tmux session is gone.
mdocker terminal prune <name>terminal name
Section titled “terminal name”Print the tmux session name for a session id.
mdocker terminal name <name> <session-id>terminal tools
Section titled “terminal tools”List available tools with availability (JSON).
mdocker terminal toolsterminal path / editor-path
Section titled “terminal path / editor-path”Get or set the AI session start path, and a separate “open in editor” path.
mdocker terminal path <name> [<path>]mdocker terminal editor-path <name> [<path>]A start path may be absolute, ~/-relative, or relative to the project directory.
terminal exec
Section titled “terminal exec”Open a tmux-attached docker compose exec shell in a container.
mdocker terminal exec <name> <service> [<shell>]The default shell is bash. The invocation respects the project’s COMPOSE_FILE
chain (original + override).
Related
Section titled “Related”- AI Terminal Sessions
spedy— start a session with a ticket as context- Attached Terminals (SwiftTerm)