https://www.aitasks.io/docs/tuis/monitor/Recent content in Monitor on aitasksHugoenhttps://www.aitasks.io/docs/tuis/monitor/how-to/Mon, 01 Jan 0001 00:00:00 +0000https://www.aitasks.io/docs/tuis/monitor/how-to/<h3 id="how-to-start-the-monitor">How to Start the Monitor</h3> <p><strong>Recommended — via <code>ait ide</code>:</strong></p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>ait ide </span></span></code></pre></div><p>This is the one-command path to the ait tmux IDE. <code>ait ide</code> resolves the tmux session name from <code>tmux.default_session</code> in <code>project_config.yaml</code> (defaulting to <code>aitasks</code>), creates or attaches to that session, and opens a <code>monitor</code> window inside it. Because it always passes an explicit session name, the <a href="reference/#session-name-fallback-dialog">session-rename dialog</a> never fires.</p> <p><strong>Standalone — from inside an existing tmux session:</strong></p> <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>ait monitor </span></span></code></pre></div><p>Run this from within a tmux session you already have open. Monitor attaches to the current session.</p>https://www.aitasks.io/docs/tuis/monitor/reference/Mon, 01 Jan 0001 00:00:00 +0000https://www.aitasks.io/docs/tuis/monitor/reference/<h3 id="keyboard-shortcuts">Keyboard Shortcuts</h3> <h4 id="zone-navigation">Zone Navigation</h4> <table> <thead> <tr> <th>Key</th> <th>Action</th> <th>Context</th> </tr> </thead> <tbody> <tr> <td><code>Tab</code></td> <td>Cycle focus to the next zone (pane list ↔ preview)</td> <td>Global</td> </tr> <tr> <td><code>Shift+Tab</code></td> <td>Cycle focus to the previous zone</td> <td>Global</td> </tr> <tr> <td><code>Up</code></td> <td>Focus the previous card in the pane list</td> <td>Pane list zone</td> </tr> <tr> <td><code>Down</code></td> <td>Focus the next card in the pane list</td> <td>Pane list zone</td> </tr> <tr> <td><code>q</code></td> <td>Quit monitor</td> <td>Global</td> </tr> </tbody> </table> <h4 id="pane-interaction">Pane Interaction</h4> <table> <thead> <tr> <th>Key</th> <th>Action</th> <th>Context</th> </tr> </thead> <tbody> <tr> <td><code>Enter</code></td> <td>Send an <code>Enter</code> keystroke to the focused tmux pane</td> <td>Pane list zone</td> </tr> <tr> <td><code>Enter</code></td> <td>Send an <code>Enter</code> keystroke to the focused tmux pane</td> <td>Preview zone</td> </tr> <tr> <td>Any other key</td> <td>Forwarded to the focused tmux pane (characters, Ctrl-combos, arrows, Escape)</td> <td>Preview zone</td> </tr> <tr> <td><code>s</code></td> <td>Switch tmux focus to the focused pane (<code>tmux switch-client</code>)</td> <td>Pane list zone</td> </tr> <tr> <td><code>i</code></td> <td>Show the task detail dialog for the focused agent pane (requires a task ID in the window name)</td> <td>Pane list zone</td> </tr> <tr> <td><code>k</code></td> <td>Kill the focused pane after confirmation (<code>tmux kill-pane</code>)</td> <td>Pane list zone</td> </tr> <tr> <td><code>n</code></td> <td>Pick the next ready sibling task for the focused agent pane</td> <td>Pane list zone</td> </tr> </tbody> </table> <h4 id="monitor-controls">Monitor Controls</h4> <table> <thead> <tr> <th>Key</th> <th>Action</th> <th>Context</th> </tr> </thead> <tbody> <tr> <td><code>j</code></td> <td>Open the TUI switcher overlay</td> <td>Global</td> </tr> <tr> <td><code>r</code></td> <td>Refresh the pane list and preview immediately</td> <td>Global</td> </tr> <tr> <td><code>F5</code></td> <td>Refresh the pane list and preview immediately (alias for <code>r</code>, hidden in footer)</td> <td>Global</td> </tr> <tr> <td><code>z</code></td> <td>Cycle the preview size through S / M / L presets</td> <td>Global</td> </tr> <tr> <td><code>a</code></td> <td>Toggle auto-switch mode (automatically focus idle agents needing attention)</td> <td>Global</td> </tr> </tbody> </table> <blockquote> <p><strong>Note:</strong> In the preview zone, every keystroke that is not handled by a global binding is forwarded to the tmux pane via <code>tmux send-keys</code>. Special keys (Enter, Escape, Backspace, arrows, Space, Delete, Home, End, PageUp/Down) and Ctrl-combinations are translated; regular characters are sent literally.</p>