Getting started
Lanework is a native Mac kanban app. Its boards are plain folders of Markdown files, so the app, a text editor and an AI agent can all work on the same board. This page says why a board and an agent belong together, then sends you down one of two tracks.
Why share a board with an agent
Section titled “Why share a board with an agent”A chat with an agent ends, and its plan goes with it. A board does not. Five things follow from keeping the work on a board.
- The board stays. The plan, the work and the decisions are files on disk. They are still there tomorrow, for you and for the next agent.
- Lanes say who acts next. A lane’s notes say what its cards are waiting for. The agent reads them, so it knows whether a card is its turn or yours.
- Moving a card is the instruction. Drag a card into the lane an agent works from, and you have told it what to do. There is nothing to type. The agent picks the card up the next time it looks at the board, or at once when it is watching.
- Questions come to you as waiting flags. When the agent needs a decision, it asks in the card’s thread and flags the card. The card wears a mark and its lane counts it, so you find the question without hunting for it.
- One set of files. The app and the agent read and write the same files. You see the agent’s work the moment it lands, and it sees yours.
What you need
Section titled “What you need”- A Mac running macOS 26 or later.
- The app. Lanework is in public TestFlight beta: join from laneworkapp.com.
- For the agent track, an AI agent that can read and write files, such as Claude Code.
Choose a track
Section titled “Choose a track”- Your first board with Claude: install the Lanework skills in Claude Desktop, have Claude found a board, and work it by talking. Start here if you use Claude.
- Running agents from the board: move a card into a lane and agents act on it, ask you questions as waiting flags, and close with evidence. Read it after your first board.
- A tour by hand: make a board from a template, then make one card, edit it, label it, comment on it and move it to the last lane. No agent is involved.
How a board is stored
Section titled “How a board is stored”A board is a folder whose name ends in .lanework. Each lane is a folder inside it, each card is a folder inside its lane, and every one of them holds an index.md. The full layout, and the validator that checks a hand-written file, are in Folder layout and tools.
Where to go next
Section titled “Where to go next”- User Guide: using the app, task by task.
- Reference: every file and key behind a board, for editing boards by hand or with an agent.