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.
Show a preview before importing
Count the skipped rows in the summary
Parse the header row
Read big files in chunks
Try a file with no header
Skip rows with no email
| Step | What you do |
|---|---|
| Catch it | Copy it from your agent, or select it and press Left Shift twice. It lands in Flow |
| Make it a card | Drag 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 issue | Pick Mark as an issue in the card's menu. It takes the board's next number |
| Hand it back | Pick Send to Flow on the card, then drag it from Flow into your agent's composer |
| Close it | Drag 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.
| # | Name | Status | Priority | Labels |
|---|---|---|---|---|
| #3 | Show a preview before importing | To do | High | FeatureDesign |
| Count the skipped rows in the summary | To do | Medium | ImportData | |
| #5 | Dates in other formats aren't parsed yet. | To do | ||
| #4 | Read big files in chunks | In progress | Medium | FeatureData |
| Try a file with no header | In progress | DataBug | ||
| #2 | Skip rows with no email | Done | Low | Bug |
| #1 | Parse the header row | Done | High | BugImport |
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.
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
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.
| Kind | What it holds |
|---|---|
| Login | A username, a password and a URL |
| .env | Paste a whole file and it splits into key and value rows |
| Token | One API key or token |
| Note | Any 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
.envfile 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.
| Route | What happens |
|---|---|
| Flow to a list | Drop 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 card | Drop a Flow card on a card's front and its files and keys attach to it |
| Flow to a board | Pick 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 Flow | Send 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 board | Attach 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.
| What | How it works |
|---|---|
| Saving | Automatic, a moment after each change |
| Where | .scratchboard files in your folders |
| Opening | Double-click a .scratchboard file in Finder |
| Finding a file | Reveal in Finder, in the bar above the board |
| Account | None needed |
| Network | Not needed |
What are the keyboard shortcuts in Boards?
Boards has nine keyboard shortcuts, for cards and for the text inside them.
| Press | What happens |
|---|---|
| N | New card |
| Enter | Open the focused card |
| Esc | Close the card |
| ⌘F | Search cards |
| ⌘S | Save now |
| ⌘Enter | Post a comment |
| ⌘B | Bold |
| ⌘I | Italic |
| ⌘E | Inline 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.
In Boards, a plain card is ticked when it is complete, and an issue has a number, such as #12, and is open or closed. Any card can be marked as an issue from its menu and made a plain card again. Issue numbers are never reused, and moving either into a Done list completes or closes it.
Yes. Boards turns what your agent finds into issues through Flow. Copy a line from your agent, or select it and press Left Shift twice, and it lands in Flow. Drag it from Flow onto a list and it becomes a card, then mark it as an issue to give it a number. Send to Flow hands the card back, ready to drag into your agent's composer.
No. Boards saves every board as a .scratchboard file in a folder on your Mac, automatically, a moment after each change. Your work starts in Home, a Scratchit folder in Documents, and you can link any other folder as a project.
A .scratchboard file is one Boards board saved as a JSON text file, with its lists, cards, labels and sealed secrets. Attachments stay where they are on your Mac and the board links to them. Double-click a .scratchboard file in Finder and it opens in Scratchit.
Yes. Boards works offline. It needs no account and no network, and every board stays on your Mac.
Yes. In Boards, a card's Secrets tab keeps logins, tokens, .env files and private notes sealed with your Mac's keychain. Revealing or copying one asks for Touch ID, a paired Apple Watch or your password, and a copied secret is cleared from the clipboard after 30 seconds.
Partly. A Boards file opens on another Mac, but its secrets open only on the Mac that sealed them, and its attachments still point at files on the first Mac.
No. Each Boards board is a file on one Mac, for one person. Boards has no live sharing and no assignees.
No. Boards has no AI features. It works beside your AI agent through Flow, which carries what the agent finds onto a board and hands cards back to it.
No. Boards is part of Scratchit, a Mac app that costs $14.99 once, or ₹299.99 in India, plus tax, with no subscription. It comes with Flow and Draw.