https://www.aitasks.io/docs/tuis/trails/Recent content in Trails on aitasksHugoenhttps://www.aitasks.io/docs/tuis/trails/how-to/Mon, 01 Jan 0001 00:00:00 +0000https://www.aitasks.io/docs/tuis/trails/how-to/<h3 id="how-to-open-a-trail">How to Open a Trail</h3> <p>Run <code>ait trails</code>, or press <strong>j</strong> then <strong>i</strong> from any other TUI. The TUI opens straight into the <strong>trail selector</strong>, which lists every trail in the project; choose one and its waves are drawn as columns.</p> <p>If you close the selector without choosing, the subtitle reads <code>no trail selected — press s</code>. Press <strong>s</strong> to open the selector again.</p> <p>If the project has no trails yet, the TUI says so. Create one with the <a href="https://www.aitasks.io/docs/skills/aitask-trail/"><code>/aitask-trail</code></a> skill in your coding agent, or with <strong>T</strong> on a task card in the board — see <a href="https://www.aitasks.io/docs/workflows/implementation-trails/#creating-a-trail">Creating a Trail</a>.</p>https://www.aitasks.io/docs/tuis/trails/reference/Mon, 01 Jan 0001 00:00:00 +0000https://www.aitasks.io/docs/tuis/trails/reference/<h2 id="keybindings">Keybindings</h2> <p>Every key below can be rebound — press <strong>?</strong> for the in-place editor, or open <a href="https://www.aitasks.io/docs/tuis/settings/#shortcuts-s">Settings → Shortcuts</a>. See <a href="#shortcut-scope">Shortcut scope</a> for how a rebind here relates to the board.</p> <table> <thead> <tr> <th>Key</th> <th>Action</th> <th>Context</th> </tr> </thead> <tbody> <tr> <td><code>s</code></td> <td>Open the trail selector — re-scans the project for trails first</td> <td>Any time; the selector also opens on launch</td> </tr> <tr> <td><code>r</code></td> <td>Re-read task files from disk and redraw the loaded trail</td> <td>Trail selected</td> </tr> <tr> <td><code>d</code></td> <td>Fetch the active trail again from storage and re-check its freshness</td> <td>Trail selected</td> </tr> <tr> <td><code>R</code></td> <td>Open the agent workflow that re-authors the active trail</td> <td>Trail selected; not while a launch is already starting</td> </tr> <tr> <td><code>v</code></td> <td>Open the trail&rsquo;s summary in a scrollable dialog</td> <td>The trail has a summary</td> </tr> <tr> <td><code>T</code></td> <td>Open the <code>/aitask-trail</code> creation workflow for the focused task — the workflow confirms before it writes</td> <td>Focused live local card (a ghost card, or no focus, gives a warning)</td> </tr> <tr> <td><code>Enter</code></td> <td>Open the focused member&rsquo;s detail screen</td> <td>Focused card</td> </tr> <tr> <td><code>Up</code> / <code>Down</code> / <code>Left</code> / <code>Right</code></td> <td>Move between cards and waves</td> <td></td> </tr> <tr> <td><code>j</code></td> <td>TUI switcher</td> <td></td> </tr> <tr> <td><code>?</code></td> <td>Shortcut editor</td> <td></td> </tr> <tr> <td><code>q</code></td> <td>Quit</td> <td></td> </tr> </tbody> </table> <h3 id="in-the-detail-screen">In the detail screen</h3> <table> <thead> <tr> <th>Key</th> <th>Action</th> </tr> </thead> <tbody> <tr> <td><code>a</code></td> <td>Reveal the whole trail document, or return to the focused member&rsquo;s own material</td> </tr> <tr> <td><code>Escape</code></td> <td>Close the detail screen</td> </tr> </tbody> </table> <h2 id="what-each-refresh-reads">What each refresh reads</h2> <table> <thead> <tr> <th>Key</th> <th>Task files</th> <th>Stored trail</th> <th>List of trails</th> </tr> </thead> <tbody> <tr> <td><code>r</code></td> <td>Re-read</td> <td>Not read — the loaded copy is redrawn</td> <td>Not read</td> </tr> <tr> <td><code>d</code></td> <td>—</td> <td>Fetched again, then freshness re-checked</td> <td>Not read</td> </tr> <tr> <td><code>s</code></td> <td>—</td> <td>—</td> <td>Re-scanned</td> </tr> <tr> <td><code>R</code></td> <td>—</td> <td>A new version is written by the agent after you confirm; the view reloads it when it lands</td> <td>—</td> </tr> </tbody> </table> <p>None of <code>r</code>, <code>d</code> and <code>s</code> writes anything. For the costs of each key and the drift reasons a card can show, see <a href="https://www.aitasks.io/docs/tuis/board/reference/#by-trail">By-Trail</a> in the board reference — the view is the same.</p>