Zum Inhalt springen

terminal

mdocker terminal verwaltet projektbezogene tmux-Sessions. Der Session-Zustand liegt unter .projects[<name>].sessions[] in der Registry; die tmux-Sessions heißen mdocker__<projekt>__<id>. Siehe AI-Terminal-Sessions.

Legt eine neue Session an.

mdocker terminal new
mdocker terminal new <name> --tool <claude|copilot|shell> [--sandbox | --no-sandbox]

--sandbox entspricht dem --sandbox-Flag von Claude Code; für copilot wird es ignoriert (dort gibt es derzeit kein Sandbox-Flag).

Listet Sessions auf (alive wird live ermittelt).

mdocker terminal list
mdocker terminal list <name>
mdocker terminal list <name> --json
mdocker terminal list --all # every project in one call

--all liefert [{ project, sessions: [...] }] für jedes Registry-Projekt, das Sessions hat; Projekte ohne Sessions werden übersprungen. Die macOS-App setzt pro Poll-Tick genau diesen einen Aufruf ab.

Jede lebende Session trägt drei zusätzliche Felder, die aus tmux gelesen werden:

Feld Quelle Bedeutung
activity #{window_activity} Epoch der letzten Pane-Aktivität (null, wenn nicht lesbar).
exited #{pane_dead} true, sobald der Prozess des Panes beendet ist.
title #{pane_title} Titel, den das Programm per OSC 0/2 setzt; null, wenn leer oder nur der Hostname-Standard.

Sessions werden mit den tmux-Optionen status off (keine Statusleiste) und set-titles on angelegt.

Beendet eine Session.

mdocker terminal kill
mdocker terminal kill <name> <session-id>

Entfernt Registry-Einträge, deren tmux-Session nicht mehr existiert.

mdocker terminal prune
mdocker terminal prune <name>

Gibt den tmux-Session-Namen zu einer Session-ID aus.

mdocker terminal name
mdocker terminal name <name> <session-id>

Listet die verfügbaren Tools samt Verfügbarkeit auf (JSON).

mdocker terminal tools
mdocker terminal tools

Liest oder setzt den Startpfad für AI-Sessions sowie einen separaten Pfad für „im Editor öffnen“.

paths
mdocker terminal path <name> [<path>]
mdocker terminal editor-path <name> [<path>]

Ein Startpfad darf absolut, ~/-relativ oder relativ zum Projektverzeichnis sein.

Öffnet eine per tmux angehängte docker compose exec-Shell in einem Container.

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

Die Standard-Shell ist bash. Der Aufruf berücksichtigt die COMPOSE_FILE-Kette des Projekts (Original + Override).