Lanework Blog

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

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:

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:

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

That’s all there is to starting. Make a board, put this week on it, and see how it feels by Friday.