Launching & Shortcuts
The window is designed to live in the background and appear on a keystroke. The desktop integration tasks bind Ctrl+Shift+Space to show or hide it:
- Ubuntu:
task integration:ubuntu - Fedora:
task integration:fedora - macOS:
task integration:macos
On Linux these install agent-gui into ~/.local/bin/agent-gui, add a desktop
entry, and (on GNOME) bind the shortcut for you; on KDE Plasma you bind
Terminal Agent Popup to the shortcut yourself in System Settings. On macOS the
task builds a Terminal Agent.app bundle in ~/Applications/ and symlinks the
binary. See the Integration guides for the per-platform
details.
To run it directly during development, use task run:gui. The window opens at a
default size of 860×600 and is resizable. Closing the window hides it rather than
quitting, so the next shortcut press brings it straight back; where the desktop
supports it, a system tray menu offers Show, Hide, and Quit.
Input and keyboard shortcuts
The input box is multi-line and word-wrapped. The sidebar on the left switches
between Ask, Task, History, and Settings; the model currently in
use is shown in the top-right (MODEL: provider / model) with a status dot. Each
mode keeps its own view, so switching tabs does not discard the last run.
| Shortcut | Action |
|---|---|
| Enter | Submit the prompt |
| Shift+Enter | Insert a newline |
| Esc | Hide the window (or close an open detail/dialog) |
| Cmd/Ctrl+L | Focus the input box |
| Cmd/Ctrl+Q | Quit the app |
| Ctrl+Shift+Space | Show/hide the window (set by the integration tasks) |