Getting started with Lanework, by hand
Lanework is a kanban app for the Mac. Its boards are plain folders of Markdown files, and the app is a live view of them.
That gives a board two ways in. You can work it by hand, in the app, the way you’d use any kanban board. Or you can hand it to an AI agent, which reads and writes the same files while you watch the cards move. Most people end up doing both, on the same board.
They’re two ends of the same pool, and it’s easier to get in at one of them. This post starts at the app end, with no AI anywhere in it. If you’d sooner start with an agent, read Getting started with Lanework, with an agent.
It takes about ten minutes.
What you need
- A Mac running macOS 26 or later.
- The TestFlight app, free on the Mac App Store. Lanework is in public beta, and TestFlight is how Apple hands out betas.
You don’t need an account. Lanework has no sign-in, no server and no setup screen.
Step 1: Install the beta
Open the Lanework beta invitation on your Mac. TestFlight opens and offers to install Lanework. Click Install, then Open.
TestFlight also delivers updates, so you’ll get new builds as they come out.
Step 2: Make your first board
Lanework opens on its Welcome window. Click New Board….
You’ll be asked to choose a template. Four come with the app:
- Basic has two lanes, To Do and Done.
- Classic Kanban adds In Progress between them.
- Software Project runs from Backlog through Review to Done.
- Bug Tracker is shaped for triaging and fixing reports.
Pick Classic Kanban if you’re not sure. A template is only a starting point, and you can rename, add and remove lanes later.
Click Choose, give the board a name, pick a folder, and click Create. Your board opens in its own window.
A word on where to put it. A board is a single item in Finder, like any document, and it works anywhere you keep files. Your Documents folder is fine. Put it in iCloud Drive and it follows you to your other Macs. Put it in a project’s git repository and it sits right next to the work it tracks.
Step 3: Add some cards
Press ⌘N. A new card appears with its title ready to type. Type something and press Return.
You can also double-click an empty spot in a lane, which puts the new card in that lane.
Add four or five. Real ones are best: the things you actually mean to do this week will teach you more about the app than “Test card 1”.
Step 4: Move things around
Drag a card to another lane. The other cards make room as you go, and a placeholder shows where it will land.
Drag a card up or down in its lane to change its place. Drag a lane by its title to reorder the lanes. To add a lane, choose File ▸ New Lane (⇧⌘N).
That’s the core of it. Cards move left to right as the work moves along.
Step 5: Open a card
Double-click a card and it opens in its own window. A card has more room in it than its face shows:
- A body. Write as much as you like, in Markdown. Checklists, links, code and images all work.
- Comments. A running thread beside the body, for notes as the work goes on.
- Attachments. Drop files onto the card and they’re kept with it.
- Labels and a due date. Small chips on the card’s face, so you can see what matters at a glance.
Once a board fills up, press ⌘F to search. It looks through every card’s title, body and comments.
Step 6: Look behind the curtain
You can skip this step, but it’s the one that shows you what makes Lanework different.
Find your board in Finder, right-click it and choose Show Package Contents. You’ll see a folder for each lane, and inside each one, a folder for each card. Every card has an index.md. Open one in any text editor and there’s your card: a title at the top, then the body you wrote.
Now change the title in the text editor and save. Look at Lanework. The card has already changed.
Those files aren’t a copy of your board. They are your board, and the app is a live view of them. That’s why there’s no export button, and no account. If you’d like the full tour of what’s in there, I wrote one: Anatomy of a Lanework board.
The other end of the pool
Everything you’ve done so far, an AI agent can do too. It can make boards, file cards, move them along and leave you notes, and it does it by editing the same files you just looked at.
That’s a different way of working, and it gets its own guide: Getting started with Lanework, with an agent. Come back to it whenever you like. The board you made today will work there as it is.
A few good habits
Keep cards small. A card that can move to Done in a day or two is a card that will. A card called “Redo the website” tends to sit there.
Let the lanes tell you what’s next. If In Progress has eight cards in it, you’re not doing eight things. You’re stuck on some of them. Finish one before you pull another.
Write things down on the card. A sentence in a comment today saves you ten minutes of remembering next week.
Where to go next
- The documentation covers every part of the app, task by task.
- Found a bug, or have a question? Open an issue on the support page. This is a beta, and those reports decide what gets fixed first.
That’s all there is to starting. Make a board, put this week on it, and see how it feels by Friday.