Uhhhhhh...
Documentation

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.

  1. Download the app for Mac and open it.
  2. Point it at a local Git repo with the folder picker — nothing leaves your machine.
  3. Explore the file canvas, or ask the AI chat about the parts you care about.
  4. Capture a ticket, generate approaches, and pick the one that fits.
  5. 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