README file from
GithubKanban Archiver
An Obsidian plugin by Starsha that automatically archives completed Kanban cards older than a configurable number of days to a separate archive file — keeping your boards clean without losing history.
Features
- Archive completed cards older than N days (default: 30) to
Archive_[boardname].md - Treats all cards in your Done column as completed, whether ticked
[x]or not - Auto-stamps today's date on any card you tick
[x]that has no existing date — so every card is always archivable - First-run migration prompt: detects undated completed cards and offers to stamp them in bulk
- Undated cards are archived to a separate
### Undated (review)section so nothing is silently lost - Configurable Done column names — works with any naming convention
- Archive file path shown in plugin settings — no mystery about where your history goes
- Works on the current file or vault-wide across all Kanban boards
Recommended Board Structure
For best results, use the standard Kanban list naming convention:
| List | Purpose |
|---|---|
| To do | Cards not yet started |
| Doing | Cards actively in progress |
| Done | Completed cards — archived automatically by this plugin |
This plugin is configured by default for a Done column. If your board uses a different name (e.g. Completed, Closed), update the Done column names setting accordingly — comma-separated for multiple columns.
Note for beginners: Unlike some tools (e.g. Salesforce which uses "In Progress" instead of "Doing"), the To do / Doing / Done convention is the most widely recognised Kanban standard and works out of the box with this plugin.
Installation
From Obsidian Community Plugins (recommended)
- Open Obsidian Settings → Community plugins
- Turn off Restricted mode
- Browse → search "Kanban Archiver"
- Install and enable
Manual install
- Download
kanban-archiver-[version].zipfrom Releases - Extract into your vault's plugin folder:
<vault>/.obsidian/plugins/kanban-archiver/ - Enable in Settings → Community plugins
Usage
Archive current board
Ctrl+P → Archive completed items older than threshold
Archive all boards
Ctrl+P → Archive completed items in all Kanban boards
Auto-stamp
Tick any card — if it has no date, today's date is automatically appended. No manual work needed.
Settings
| Setting | Default | Description |
|---|---|---|
| Days threshold | 30 | Archive completed items older than this many days |
| Archive file prefix | Archive_ |
Prefix for generated archive files |
| Auto-stamp on completion | On | Append today's date when ticking a card with no existing date |
| Done column names | Done |
Comma-separated list of column names treated as completed |
| Archive locations | — | Read-only display of resolved archive paths for each board |
| Re-run migration | — | Trigger the first-run undated card migration prompt again |
Archive file format
Archive files are created in the same directory as the board:
Board Kanban/
├── Board daily stuff.md
├── Board projects.md
├── Archive_Board daily stuff.md ← auto-created
└── Archive_Board projects.md ← auto-created
Each archive run appends a dated section:
## Archived 2026-05-26
- [x] Completed task (@2026-04-10)
- [x] Another task 2026-03-15
### Undated (review)
- [x] Old task with no date
License
MIT — free to use, modify, and distribute.
Author
Starsha — kworld.space