Mooring docs

Cards

The Cards tab in the right-hand panel, where what comes next becomes cards, typed or dictated, moved through a workflow, and handed to Claude.

The Cards tab is where each project lines up its work as cards. It is one of three tabs in the panel on the right of the window, beside Files and Changes. Click the Cards tab, choose View ▸ Show Cards, or press ⌥⌘3, to show it. Press ⌥⌘3 again to shut the panel and give the terminal the room. The round button at the right end of the title bar opens and shuts the panel too, on the tab it showed last. A new install starts with the panel open on the Cards tab. (Mooring 0.20 and earlier call this tab Up Next.)

Mooring’s main window. In the sidebar, skiver’s tile, reading SKV, its ticket code, sits in the column on the left, and the panel beside it lists the main folder and three worktrees, each named by its card, with the questions last asked of Claude under the first. The middle is that worktree’s Claude tab, where Claude has just added a sweep that clears stale typing indicators. On the right, the Cards tab lists seven cards, each with its key, status in colour, priority, title and description, among them “Dave has been typing for three days” and “Paginate #random.”

Add a card

  1. Press ⌘N, or click the New note box at the top of the Cards tab.
  2. Type the card.
  3. Click Add, or press ⌘⏎.

To dictate instead, press ⌥⌘M to start and stop, or click the microphone in the box. Dictation runs on your Mac, so nothing you say leaves it. See Voice input. You never have to speak: everything has a keyboard way too.

To attach a file or image, drag it onto the New note box, paste an image, or use the attach buttons in the box.

In a project with no cards yet, the Assistant points to the New note box.

Find cards

  • The chips at the top filter by status: All, Ready, In Progress, In Review, Done, Blocked and Cancelled. Select more than one chip to combine statuses.
  • The Tags button narrows the list by tag.
  • The Search Cards field, or ⌘F (Edit ▸ Find in Cards), searches titles, descriptions, tags and ticket keys. A search for 42, #42 or SKV-42 finds card SKV-42. Esc clears it.
  • All clears every filter at once.

Sort and organise

Cards sort by priority, newest first. To change it, click the sort control in the Cards header and choose Priority, Created, Last updated or Recently done, and a direction.

Right-click a card to set its Priority or Tags.

On a Mac with Apple Intelligence, the Assistant menu at the top of the Cards tab also has Suggest Tags for Untagged and Re-tag Everything…. Mooring proposes tags that group related cards, on your Mac, and you choose which to apply. ⌘Z undoes them.

To move a card to another project, drag it onto that project's tile in the sidebar. Hold ⌥ as you drop to copy it instead.

Archive a card

  1. Select the card.
  2. Press ⌘⌫, or right-click it and choose Archive.

The card leaves the Cards tab straight away. Press ⌘Z to bring it back. Click the Archived chip to see every archived card. Select one there and press ⌘⌫, or choose Restore, to put it back.

To remove a card for good, with its comments and history, right-click it and choose Delete Permanently…. Mooring asks first.

Open a card

Select a card and press ⌘⏎, or click the open button that appears when you point at it. The left side of the card's window has:

  • The description and acceptance criteria. Click the edit button beside either one to change it.
  • Comments, with attachments. Removing a comment, attachment or link doesn't ask first. A deleted comment leaves Comment deleted · Restore in its place until you leave the card, so you can click Restore to put it straight back. ⌘Z puts it back too. Later, click N deleted at the top of the comments to see what you removed and restore any of it.
  • History, every change to the card, and who made it: you, Claude, or Mooring itself.

The right side has two tabs. Press ⌘1 for Details and ⌘2 for Assistant. Mooring remembers the one you used last.

  • Details holds the card's status and priority, a short summary written on your Mac by Apple Intelligence, Relations to other cards (blocks, relates to, duplicate of, split from and merged into), the Release and Fix versions, attachments and tags. A card on a worktree also has Mark As, for the marks on that worktree. See Worktrees.
  • Assistant is a chat with Claude about this one card. See Assistant.
A Mooring card window for SKV-1, “Dave has been typing for three days.” The left side shows the description, three acceptance criteria and a comment thread in which Claude explains the cause. The right-hand rail shows the status (In Progress), priority (High), an AI summary of the card, tags, and an Ask the Assistant section with suggested questions.

Ticket keys

Each card gets a ticket key, such as SKV-42. The letters are the project's ticket code, which you can change in the project's Get Info… window. Cards Claude creates get keys the same way. Click a ticket key to copy it.

Hand a card to Claude

  • Drag a card onto a tab to send it to that session. Claude gets the card's text with its ticket key, and can read the rest of the card with Mooring's tools. The card you carry tilts a little, as if lifted off the list, and its place in the list fades until you let go.
  • Right-click and choose Send to send the card to the selected tab, or Send Body Only to leave out its title. The card moves to In Progress. With no tab to send to, Mooring copies the text instead, so you can paste it. To press Return after sending as well, turn on Auto-Enter on send in Settings ▸ Voice Input.
  • Send it to a new worktree with ⌘S, or right-click and choose Send to New Worktree…. Mooring makes a worktree for the card and starts an agent there. See Worktrees.

To see the cards linked to a worktree, right-click its row in the sidebar and choose Cards on This Worktree…. On the main folder's row the item is Cards on This Project Folder…. A worktree with a linked card also offers Open Card and Show in Cards, which shows that card in the Cards tab.

Assistant

The Assistant menu at the top of the Cards tab opens a chat with Claude about your cards, or one of your saved jobs, such as Find duplicates. It works on the cards the tab is showing, so filter first. See Assistant.

Favourites

Below the cards, Favourites holds text you reuse, such as prompts and templates. To show or hide it, click the star at the top of the Cards tab, or press ⌥⌘4 (View ▸ Show Favourites). If the panel is shut, ⌥⌘4 opens it on the Cards tab first. The tray button beside the star, labelled Cards, shows or hides the list of cards.

Right-click a favourite and choose Make Global to use it in every project. Press ⇧⌘K to search your favourites and send one to the selected tab.

See also