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

Create a new session.

mdocker terminal new

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

List sessions (alive computed live).

mdocker terminal list

mdocker terminal list <name>
mdocker terminal list <name> --json

terminal kill

End a session.

mdocker terminal kill

mdocker terminal kill <name> <session-id>

terminal prune

Drop registry entries whose tmux session is gone.

mdocker terminal prune

mdocker terminal prune <name>

terminal name

Print the tmux session name for a session id.

mdocker terminal name

mdocker terminal name <name> <session-id>

terminal tools

List available tools with availability (JSON).

mdocker terminal tools

mdocker terminal tools

terminal path / editor-path

Get or set the AI session start path, and a separate “open in editor” path.

paths

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

Open a tmux-attached docker compose exec shell in a container.

mdocker terminal exec

mdocker terminal exec <name> <service> [<shell>]

The default shell is bash. The invocation respects the project’s COMPOSE_FILE chain (original + override).

Related

• AI Terminal Sessions
• Attached Terminals (SwiftTerm)