Terminal sessions¶
Each terminal session is a real pseudo-terminal running your login shell. It
starts at the active project's root and uses the shell environment available to
ködade, including your login-shell PATH. If no shell is identified in the
environment, ködade falls back to /bin/zsh.
Start a session¶
The first time you add or activate a project with no live sessions, ködade opens
one at the project root. Default names use your shell name and a number, such as
zsh 1 and zsh 2.
Press Command-T while a project is active to add another session. You can also start a detected agent in a new terminal from the launch control in the full sidebar.
Switch sessions¶
Select a terminal workspace card in the full projects sidebar. Selecting a workspace under a different project activates both that project and its terminal.
Only one terminal is visible at a time, but other sessions remain live. A steady status dot marks a live session. When ködade can identify a foreground command, the row can temporarily show that process name and pulse its status dot.
Rename a session¶
Double-click the workspace name, enter a name, then press Return or click away
to commit it. Press Escape to cancel. An empty name keeps the current name.
A manual name takes priority over temporary foreground-process naming. The session identity and manual name persist across an app restart.
Close a session¶
Select × on the workspace card. Closing a session kills that session's shell. If you close the active session, ködade selects the newest remaining session for that project when one exists.
If a shell exits on its own, its dimmed row remains so you can inspect the
terminal output. Close that row when you are finished with it. After closing the
last session, select + new session or press Command-T to start another.
Quitting ködade stops its live terminal processes. On restart, saved session identities reopen as fresh shells with their saved names. The previous process and terminal output are not restored.
Paste paths by dragging¶
Drag one or more files or folders from Finder onto the visible terminal. ködade
pastes their absolute paths at the prompt as shell-quoted arguments and leaves a
space after the last one. Review the command and press Return yourself.
The drop does not run a command. Filenames containing spaces or apostrophes are quoted for the shell.
Drop location changes the result:
- Onto a live terminal: paste the paths into that session.
- Elsewhere in the app: add any dropped folders as projects.
- Onto an empty terminal with no live session: a dropped folder follows the add-project path.
To run agent tools in a session, continue with Agent CLIs.