How Uhhhhhh works
Everything between “ticket created” and “first commit” — the canvas, the AI chat, the approaches, the commits. Here's what each piece does and why it's there.
Getting started
Agents can write almost any code now — the tricky part is deciding what to build. Uhhhhhh helps with exactly that, from the moment you have a ticket to the moment you hand your agent a plan it can run with.
- Download the app for Mac and open it.
- Point it at a local Git repo with the folder picker — nothing leaves your machine.
- Explore the file canvas, or ask the AI chat about the parts you care about.
- Capture a ticket, generate approaches, and pick the one that fits.
- Commit straight from the app once you're done.
Workspace & repositories
Point it at any local Git repository through the native folder picker — nothing is uploaded to the cloud. Add as many repos as you like; switch between them from the workspace rail and the app reloads that repo's file tree, changes, and tickets.
- Repos read their file tree from git ls-files, so ignored files stay hidden.
- Personal repos and shared organization repos live side by side in the rail.
- Switching a repo resets the canvas and selection so you always start clean.
File explorer canvas
Your repository is rendered as a live, zoomable graph instead of a flat list. Click a file node to select it and fly the viewport to it; click a folder to add it as context. In Git mode the canvas collapses to just the files a change touches and their parent folders.
- Drag to pan, scroll to zoom, or use the controls in the top-right.
- Auto-laid out with Dagre so the tree stays readable as it grows.
Git change visualisation
See the blast radius of a change before an agent touches a file. The canvas colour-codes every file by its Git status so you can spot the risky edges before the first commit.
- Yellow = modified · Green = added · Red = deleted · Indigo = renamed.
- Untracked and deleted files are injected into the graph, not just tracked ones.
- Hit refresh in the Git tab to re-read git status at any time.
Brainstorm canvas
A free-form mindmap for thinking through an approach. Drop nodes, connect them, and let the AI chat turn a question into question + idea nodes laid out on the canvas. Toggle between Free and Snappy positioning, wrap or single-line node text, and undo any change.
- Ask the AI a question and it explores the repo, then answers as nodes.
- HTTP(S) URLs in node labels become clickable links.
- Pin the files and brainstorms you return to most.
AI explorer chat
A frosted panel floats over the canvas so you can ask questions about the files you have selected and get Claude-powered answers with full markdown. Selected files and folders attach as context chips you can remove individually.
- Choose the model that fits the task — Sonnet, Opus, or Haiku.
- Conversations are saved per repo so you can pick up where you left off.
- Drag the handle to resize, or minimise to an input-only strip.
Tickets & approaches
Capture work as tickets, set a priority, and ask for a handful of distinct technical approaches — each mapped onto your real code with trade-offs spelled out. Pick the direction, tweak it, then send your agent in with a plan instead of a hope.
- Five priority levels, from low to blocker.
- Quick-ticket wizard lets you capture a ticket without leaving the canvas.
Source control & commits
Stage and commit straight from the app with a guided commit bar. Standardised messages keep the history tidy, and ⌘↵ commits without reaching for the mouse.
Keyboard shortcuts
On macOS use ⌘; on Windows and Linux the same shortcuts work with Ctrl.
Anywhere
⌘B | Toggle the sidebar |
⌘1–7 | Jump to a section by number |
⌘< | Go to the previous section |
⌘> | Go to the next section |
⌘T | Open an integrated terminal |
⌘L | Open the AI chat |
⌘⇧L | Quick ticket lookup |
Esc | Cancel, close a panel, or clear focus |
File explorer
⌘P | Search files by name |
⌘⇧F | Search inside file contents |
↵ | Open or expand the selected file |
R | Center the map |
⌘Click | Open the clicked file in the viewer |
File viewer
I | Toggle the file info panel |
⌘A | Select the file contents |
Notes panel
⌘S | Save the note |
Brainstorm & boards
⌘N | New ticket / contextual create |
Brainstorm canvas
⌘Z | Undo the last change |
⌘U | Unwrap the selected sub-node — its children move up a level |
Brainstorm & terminal
⌘Click | Open a link in your browser |
Tickets & source control
⌘↵ | Execute approach / commit |
Inputs & rename
↵ | Confirm or save the current field |

