Shell
Your own terminals on the machine Ginu runs on.
What this page covers
OutcomeKeep a terminal of your own beside the conversation, and not confuse it with an agent’s.
Before you beginMake sure tmux 3.0 or newer is available to the process running Ginu.
Follow these steps
Shell gives you terminals on the Ginu host. Each one is a tmux session, so it keeps running when you close the page and survives a restart of Ginu itself. Nothing types into these but you.
Desktop fits up to three panes, each with its own picker. Order the list by Groups or by Last touched, and move a shell between groups by dragging it or editing it.
Closing a shell names the process still running in it and asks for confirmation. An exited one keeps its output on screen, and Restart here opens a replacement in the same directory and group.
Example
Open Shell and run a familiar read-only command, such as pwd.
Your command and its output appear. Nothing types into this terminal but you — the conversation and the agents have their own.
tmux sessions, which is why they survive
Each shell is a tmux session on the Ginu host, so it keeps running when you close the page and is still there after Ginu restarts. That is the point of the surface: a long-running process does not have to live in a window you are afraid to close.
Group related sessions so you can find them again, or order the list by last touched when recency is the better clue. Desktop fits up to three panes at once; a phone shows them one at a time.
Closing a shell names the process running in it and asks first. An exited shell keeps its output, and Restart here opens a replacement in the same directory and group. Without tmux, creating one is disabled with the reason shown, and nothing else in Ginu is affected.
Notes
- Shell needs tmux 3.0 or newer. Without it, creating a terminal is disabled with the reason on screen and nothing else in Ginu is affected.
- An agent’s terminal is not one of these. That one belongs to a worker and lives under Agents; this list is yours.
Check
You can find a shell’s directory, switch between sessions, and recognise a running process before closing one.