Move the to-do list from NOTES.md to a kandown board
Each note is a task in tasks/ with the owner's words under ## Context; the board rules are in .kandown/kandown_work.md and docs/kandown.md explains how kandown works here. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# Kandown
|
||||
|
||||
File-based kanban for this project. Zero install, zero backend, plain markdown on disk.
|
||||
|
||||
## Layout
|
||||
|
||||
```
|
||||
.kandown/ # config, web UI, workflows, skills
|
||||
├── kandown.html # single-file web app — open this in your browser
|
||||
├── kandown.json # project preferences, columns, appearance
|
||||
├── kandown_work.md # optional project agent instructions
|
||||
├── workflows/ # optional local workflow packages
|
||||
├── skills/ # optional local Markdown skill packages
|
||||
└── README.md # this file
|
||||
|
||||
tasks/ # source of truth — one .md file per task
|
||||
├── t1.md
|
||||
├── t2.md
|
||||
└── archive/ # archived tasks live here
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
1. Open `.kandown/kandown.html` in Chrome, Edge, Brave or Opera (File System Access API required)
|
||||
2. Click **Select folder** and pick the **project root** (the parent of `.kandown/`), then grant read/write permission
|
||||
3. That's it
|
||||
|
||||
The app remembers the last 10 projects you've opened — no need to re-select the folder each time.
|
||||
|
||||
## Settings
|
||||
|
||||
Open Settings from the app header to tune this project. Board columns are stored in `.kandown/kandown.json` at `board.columns`. Each task chooses a column with its frontmatter `status`.
|
||||
|
||||
## Editing without the app
|
||||
|
||||
Everything is plain markdown. Edit files directly in your IDE, Obsidian, or vim. Click **Reload** in the app (or press `R`) to see changes.
|
||||
|
||||
The task editor includes a markdown-backed subtask checklist. Add steps with **Add subtask**, press **Enter** to insert another step, and expand a step to edit its description or report. Changes are saved back to the task file automatically.
|
||||
|
||||
## For AI agents
|
||||
|
||||
Run `kandown work` for the current agent protocol and live board context. Each task file in `tasks/` is its own source of truth. Moving a task means editing its frontmatter `status`.
|
||||
|
||||
## Keyboard shortcuts
|
||||
|
||||
| Key | Action |
|
||||
|---|---|
|
||||
| `⌘K` / `Ctrl+K` | Command palette |
|
||||
| `⌘1` / `Ctrl+1` | Board view |
|
||||
| `⌘2` / `Ctrl+2` | List view |
|
||||
| `N` | New task |
|
||||
| `R` | Reload |
|
||||
| `/` | Focus search |
|
||||
| `Esc` | Close drawer / palette |
|
||||
| `⌘S` | Save current task |
|
||||
| `⌘⌫` | Delete task (with confirmation) |
|
||||
Reference in New Issue
Block a user