Command line¶
Run gft inside Graffitty to control your workspace. Use gft-gui to launch the app.
For options, run gft --help or gft <command> --help.
Find and focus a pane¶
Replace %3 with an ID from the listing.
Use -L, -R, -U, or -D to focus a neighboring pane, including floating panes.
For targets and editor integration, see Select a pane.
Show an image¶
Files, directories, URLs, and piped images work. See Image display for size, alignment, SSH, and tmux options.
Give an agent workspace instructions¶
Ask the agent to run one of these:
graph covers workspace and agent controls; chromium covers browser automation.
gft skill lists all guides. These commands print instructions; they do not install skills.
Capture or type text¶
gft get-text --scrollback > terminal.txt
gft terminal type -t %3 --text 'hello'
gft terminal send-key -t %3 Enter
Typing does not press Enter. See Terminal commands for capture behavior and remote targets.
Save a layout or open files¶
| Task | Command or guide |
|---|---|
| Save the workspace | gft checkpoint save |
| Restore the latest manual save | gft checkpoint restore; see Checkpoints |
| Toggle the filetree | gft filetree |
| Open and focus the filetree | gft filetree --focus |
| Manage sessions | Session commands |
| Arrange panes | Tabs and panes |
| Connect agents | Graph commands |
| Run a tool node | Automation nodes |
Add shell completion¶
Replace zsh with bash or fish. Follow the printed setup instructions;
the command does not edit startup files. Use --force to replace an existing completion file.