Keys for your answers
This page recommends multiple key mappings that you can customise as per your liking. Some of them override default tmux bindings. If you think there are better alternatives for recommended keys happy to understand how.
All the keys are the ones that are in docs/tmux.conf.full.example bindings. The “Help says” is what you get on CLI with --help flag. You can use it with “companion: …” in your bindings for easy search.
| Key | Answers | Description |
|---|---|---|
prefix g |
Which pane had the output I was looking at? | runs: panesEvery pane on the server, with what it runs and whether it has gone quiet; enter jumps there |
prefix G |
Where’s the agent working on X? | runs: panes --agents--agents: Only the panes running one of [agents] programs |
prefix M-g |
Which agents needs an answer from me? | runs: inboxThe agents waiting on you, each with the question it asked; enter jumps there |
prefix b |
What’s today’s brief across projects? | runs: briefWhat needs you, on one screen: the agents waiting and what they asked, the health reasons, the sessions idle for days, the numbers |
prefix J |
What did I do in the project day before yesterday? | runs: journalWhat happened in each project: the commands that ran long, the questions the agents asked, the sessions opened and closed |
prefix / * |
Where did I saw “Hello World!”? | runs: searchEvery line of every pane’s scrollback in every active session, newest first; enter goes to the pane and the line |
prefix P |
What was that lsof command again? | runs: portsThe ports something is listening on and the pane that started each; enter jumps there |
M-s |
Should I open a new window or session, technically its related to this project right? | runs: projectSwitch to a project, or start one |
prefix c * |
I don’t need session for this, I think a window is enough for now? | runs: new-windowOpen a new window, here or at any directory, from the directory picker |
prefix @ |
Ah, Why didn’t I move this to separate session? | runs: promoteGive a pane a session of its own, named for the directory it is in |
prefix e |
Can I quickly run a command while editing file with less keystrokes as possible? | runs: runRun a new or previous command from history in a pane beside this one |
prefix ? * |
What was that keymap again? | runs: keysSearchable key bindings |
prefix C-c |
So which keys I have not yet CRISPR in my DNA? | runs: cheatsheetA cheat sheet of the bindings you keep looking up, in four boxes |
prefix z * |
I have to focus here, how do I de clutter? | runs: zenClear everything but the pane you are working in |
prefix ` |
Do I have foldable pane? | runs: pocketA shell you pull out beside this pane and put away, process and scrollback kept, by the same key |
prefix K |
What’s the PID for this, how do I stop it right now? | runs: kill --askStop what runs in front in a pane: TERM, and KILL if it is still there after the grace |
prefix X |
Done for the day, can all panes and windows in session be closed gracefully without lingering swap files? | runs: project closeClose this project by letting every window exit |
prefix S |
Can it remember layout and sizes of the project? | runs: project saveCapture this session’s windows and panes as this project’s layout |
prefix M-S |
Will it can but can it forget it now? | runs: project forgetDelete this project’s saved layout and fall back to the config |
prefix M-s |
Maybe I need to save all sessions before running this? | runs: sessions saveCapture every session now, as a new generation |
prefix Q |
Can the AI keep it quiet for sometime? | runs: quietQuiet hours: no notifications, no nudges and no agent count on the bar for a while; the health mark says quiet instead |
copy mode o * |
IDEs do it with easy but can my terminal do it better? | runs: openOpen a URL or file found in text |
copy mode y |
pbcopy or xclip? | runs: clipboardCopy to the system clipboard, whatever this platform calls it |
copy mode C-p C-n |
Is there easy way to jump back terminal history? | runs: tmux’s previous-prompt next-promptNeeds shell-init in your shell: Print the shell code that emits the OSC 133 prompt marks |
copy mode g * |
I’m in copy mode, what can I do with this line? | runs: tmux’s display-menuA menu over open (o, O), open -i searches (s, S) and history top (g) |
M-a |
Can I hop between the editor and the agent without the prefix? | runs: toggleMove to the next window in this session, wrapping at the end |
M-A |
Which window was I just in? | runs: toggle --lastFlip to the window this session was on before, tmux’s own last-window, instead of the next one by index |
prefix C-t |
Can this project look different from the others at a glance? | runs: theme pickPick a theme and apply it |
| click on the bar | Can I just click the agent count instead of remembering a key? | runs: clickWhat a mouse click on a segment of the bar does: bound to MouseDown1StatusRight with #{mouse_status_range} |
prefix N |
What was I doing in this pane again? | runs: noteLeave a one-line note on a pane, shown by panes and in the pane border; with nothing to say it prints the note that is there |
prefix C-r |
Laptop rebooted, where did all my sessions go? | runs: sessions resurrect --mergeRebuild a server from a snapshot; --merge: Add the sessions that are missing instead of refusing a busy server |
prefix C-i |
Which sessions haven’t I touched in days? | runs: sessions idleSessions nobody is attached to that have been quiet for days; picking one runs project close on it |
prefix M-/ |
Is there a tmux key for that already? | runs: keys --allShow every binding, including the ones tmux ships |
* replaces a tmux default:
prefix /: describe a key (list-keys -1N)prefix c:new-windowprefix ?:list-keys -Nprefix z: zoom (resize-pane -Z)- copy mode
o:other-endof the selection - copy mode
g:history-top, which the menu’s owngstill does