What is Boards?

Boards is a kanban board app for your Mac with a minimal issue tracker built in. Turn what your AI agent finds into cards and numbered issues, track them with priorities, labels and a List view, keep keys behind Touch ID, and close them when they ship. Every board is a file on your Mac.

By Sougata · Updated

Why Boards

Agents write most of the code now. What is left for you is the list. The bug your agent spotted, the edge case it skipped, the follow-up it suggested at the end of a long answer. Most developers keep that list in an issue tracker, in a browser tab far from where the work happens.

Boards keeps it beside your agent, on a kanban board with a minimal issue tracker built in. Catch a line from your agent in Flow, drop it on a list and it becomes a card. Mark it as an issue and it takes a number. When it is time, hand it back to your agent, and when it ships, drag it into Done and it closes.

Select a line your agent wrote and press Left Shift twice. It lands in Flow.

#3HighFeature, Design

Show a preview before importing

Nov 281/433
MediumImport, Data

Count the skipped rows in the summary

Nov 282/42
#1HighBug, Import

Parse the header row

#4MediumFeature, Data

Read big files in chunks

Dec 21
Data, Bug

Try a file with no header

1/32
#2LowBug

Skip rows with no email

StepWhat you do
Catch itCopy it from your agent, or select it and press Left Shift twice. It lands in Flow
Make it a cardDrag the Flow card onto a list. Its first line becomes the name, the rest the description, and its files, drawings and keys come with it
Make it an issuePick Mark as an issue in the card's menu. It takes the board's next number
Hand it backPick Send to Flow on the card, then drag it from Flow into your agent's composer
Close itDrag it into Done, or pick Close issue in its menu. Moving it out of Done reopens it

How does the kanban board work?

A kanban board in Boards is a row of lists, and every list has a state, To do, In progress, Done or Custom. Each state has its own colour, so a board reads at a glance. A new board starts with To do, In progress and Done, and you can add as many lists as you like. Use it as a personal kanban or as the task board for one project.

  • Done closes. Moving a card into a Done list completes it, or closes it if it is an issue. Moving it out reopens it.
  • Custom lists are for things that are not tasks. Keep ideas or references there. Their cards never count toward progress.
  • Progress at the top. The board shows how far along it is, such as 8 of 12 complete.
  • Drag to move. Drag cards between lists and drag a whole list to reorder it.

Is Boards an issue tracker?

Yes. Boards is a minimal issue tracker built into a kanban board. A card you add on a board is a plain card that you tick when it is complete. Mark any card as an issue and it gets a number, such as #12, and is open or closed. Numbers are never reused, and the list a card sits in is its status.

  • Priority. Urgent, High, Medium or Low, shown on the card's front.
  • Labels. Make your own, or start from Bug, Feature, Improvement, Design, Docs, Research and Chore. They show as coloured dots on the card.
  • Due dates. An overdue card shows its date in red.
  • Checklists. Progress shows on the card's front, such as 2/5.
  • Comments and activity. Comments sit on the card, and activity keeps its last ten changes.
  • Rich text. Descriptions take Markdown as you type, and code blocks get syntax highlighting, a language picker and a copy button.

There are no sprints, story points or assignees.

How does the List view work?

The List view shows every card on a board as a row. Switch to it with List in the bar above the board.

The List view of the board after the demo, seven cards as rows. Issue 3, a plain card and the new issue 5 sit in To do, issue 4 and a plain card in In progress, and issues 2 and 1 in Done, each with its number, name, status, priority and labels.
#NameStatusPriorityLabels
#3Show a preview before importingTo doHighFeatureDesign
Count the skipped rows in the summaryTo doMediumImportData
#5Dates in other formats aren't parsed yet.To do
#4Read big files in chunksIn progressMediumFeatureData
Try a file with no headerIn progressDataBug
#2Skip rows with no emailDoneLowBug
#1Parse the header rowDoneHighBugImport

In the app the List view also shows each card's due date, checklist progress and attachments, with the card's menu at the end of its row. In the List view, Status is the list a card sits in.

Click a column heading to sort by number, name, status, priority or due date. Search finds cards by name, description, checklist item or issue number, and Filter narrows the board by status, labels, priority and due date, including overdue and due this week.

Can a card hold files and screenshots?

Yes. A card holds any file from your Mac, with no size limit. An attachment is a link to the file, not a copy, so it opens, copies and drags out like the file itself, into Finder or into your agent.

Switch the tabs below to see what a card can hold. Tick its checklist and reveal its secrets.

An open card in Scratchit, issue 3, Show a preview before importing. Its properties show the type Issue, the status Open, the list To do, High priority, the labels Feature and Design and a due date of Nov 28. Six tabs hold the rest, a description with a list and a code block, a checklist of four items with one done, three attachments (a drawing named Import flow, an image named preview-mock.png and a file named contacts.csv), three secrets (a database login, a production .env file and an API token, masked until revealed), three comments and the card's activity. The type switches between card and issue, the tabs switch, the checklist ticks, and each secret reveals and hides.

Show a preview before importing

Type
Status
OpenClose issue
List
To do
Priority
High
Labels
FeatureDesign
Due date
Nov 28

Show the first 20 rows before the import runs, with the columns the header row found.

  • Rows with no email are marked, not dropped
TypeScript
const preview = rows.slice(0, 20)
  • Images show as thumbnails.
  • A screenshot on the clipboard, up to 50 MB, is saved once into a Pasted folder in Home, and the card links to it there.
  • A file that moves shows as Missing, with Locate to find it again.
  • Drawings. Attach drawing links any canvas from Draw. The card shows a preview, and a click opens the canvas.

How does Boards keep API keys and passwords safe?

A card's Secrets tab keeps logins, tokens, .env files and private notes sealed with your Mac's keychain, never stored as plain text. Revealing or copying one asks your Mac to confirm it is you, with Touch ID, a paired Apple Watch or your password. One confirmation lasts 30 seconds.

KindWhat it holds
LoginA username, a password and a URL
.envPaste a whole file and it splits into key and value rows
TokenOne API key or token
NoteAny private text
  • Masked by default. A revealed value hides again after 30 seconds.
  • Safe to copy. A copied secret is marked so clipboard managers skip it, and the clipboard is cleared after 30 seconds.
  • Export as .env writes a .env file back out, after the same confirmation.
  • Kept out of sight. A secret's value never shows in search, on the card's front or in the activity. The front shows only a lock, and the activity names a secret by its label.

A key captured in Flow comes with its card to the board, still sealed.

How does Boards work with Flow and Draw?

Boards trades cards with Flow in both directions and takes drawings from Draw.

Flow, a board and a canvas in a row, each as its glyph in its own colour, the board in the middle. Two arrows run between Flow and the board. The one to the board is marked with text, file and key glyphs, for a Flow card dropped on a list, where it becomes a card with its text, files and keys, or on a card, which takes its files and keys. The one back to Flow is marked with a card's glyph, for Send to Flow. One arrow runs from the canvas to the board, marked with a card's glyph, for a drawing attached to a card.
RouteWhat happens
Flow to a listDrop a Flow card on a list and it becomes a plain card, with its files, drawings and keys. Dropping the same one again adds nothing
Flow to a cardDrop a Flow card on a card's front and its files and keys attach to it
Flow to a boardPick Send to a board on a Flow card, then the board and the list. Set Kind to Issue and it takes its number at once
Board to FlowSend to Flow, in a card's menu or on the open card, sends its name, description, files and drawings, with a link back to the card. Its secrets stay on the card. Drawings go as links to their canvases
Draw to a boardAttach drawing on a card links any canvas, and the card shows its latest drawing

Read more about Flow and Draw.

Where are your boards saved?

Every board is a .scratchboard file in a folder on your Mac, beside your canvases. Your work starts in Home, a Scratchit folder in Documents, and you can link any other folder as a project.

A Finder window on the Scratchit folder in Documents, in list view. A Launch project folder is open, holding Tasks.scratchboard, a board, and Roadmap.draw, a canvas. An Onboarding folder is closed, and a board named Bugs.scratchboard and a canvas named Pricing ideas.draw sit beside them, each with the date it changed. Tasks.scratchboard is selected.
WhatHow it works
SavingAutomatic, a moment after each change
Where.scratchboard files in your folders
OpeningDouble-click a .scratchboard file in Finder
Finding a fileReveal in Finder, in the bar above the board
AccountNone needed
NetworkNot needed

What are the keyboard shortcuts in Boards?

Boards has nine keyboard shortcuts, for cards and for the text inside them.

PressWhat happens
NNew card
EnterOpen the focused card
EscClose the card
⌘FSearch cards
⌘SSave now
⌘EnterPost a comment
⌘BBold
⌘IItalic
⌘EInline code

When is Boards not the right tool?

Boards is not the right tool if you need any of these.

  • A team on one board. Each board is a file on one Mac, for one person, with no assignees and no live sharing.
  • Sprints, story points, roadmaps or Gantt charts. Boards tracks cards and issues, nothing more.
  • Sub-issues. An issue cannot hold other issues.
  • Importing from another tracker. Boards does not import from other tools.
  • A board on a second Mac. The file opens there, but its secrets open only on the Mac that sealed them, and its attachments point at files on the first Mac.
  • An iPad, Windows, Linux or an Intel Mac. Boards is part of Scratchit, which runs on Macs with Apple silicon.

Frequently asked questions

Both. Boards is a kanban app for Mac with a minimal issue tracker built in. Any card can be marked as an issue, which gives it a number and an open or closed status, with priority, labels, due dates, checklists and comments. A List view shows every card as a row, with search and filters.

Scratch it down, track it in a project and flow with it.

Coming soon