Skip to main content
The Gandalf TUI is a Bubble Tea based setup console that lets you inspect and manage your local AI agent configuration without leaving the terminal. This page walks through opening the console, navigating its tabs, reviewing unified inventory rows, and understanding the safety model behind every mutation.

​
Open the setup console

Start the interactive console from any project directory.
The console opens on the Home tab by default. You can move between the persistent sidebar sections using arrow keys or the displayed shortcuts. The setup console is organized into a persistent sidebar with five top level sections. Each section serves a distinct purpose. The Console section contains five sub tabs. Move between sidebar sections with ← / → or Tab / Shift+Tab. Move between Console tabs with ↑ / ↓ or the labeled shortcut keys.

​
Inspect skills with the Markdown overlay viewer

Skills that include a SKILL.md file can be opened in a read only overlay viewer.
1

Navigate to Console > Skills

Use the sidebar to open Console, then select the Skills tab.
2

Select a skill row

Move the selection cursor to the skill you want to inspect.
3

Open the overlay

Press Enter to open the Skill Markdown Overlay Viewer. This renders the SKILL.md read only and does not modify any files.
4

Close the overlay

Press Esc or q to return to the Skills tab.

​
Review Changes as a mandatory step

Every available write operation in the console starts with Review Changes. This is not optional. Gandalf enforces a preview step before any provider backed action is executed. When you select a mutation, the Changes tab activates automatically and shows:
  • The files or entries that will be modified
  • Diff style additions and removals
  • A confirmation prompt before execution
If you decline, no changes are written and you return to the prior view.
There is no bypass for Review Changes in the TUI. This is part of the Trust Contract that bounds what Gandalf can modify.

​
Timeline undo is always a preview

The Timeline section lets you inspect past operations, but its undo action remains a dry run preview. writesFiles=false is enforced for all timeline undo operations. This means you can see exactly what an undo would do, but you cannot trigger a file writing undo directly from the Timeline. Use gandalf restore with an explicit snapshot if you need to roll back to a saved baseline.

​
Keyboard shortcuts

​
Next steps