KanbaCode

VS Code Kanban extension backed by a Markdown file with live updates.

File Format

Use # for the board title, ## for columns, and Markdown task lists for cards.

# Project

## Backlog
- [ ] Define scope #planning @patrick [date: 2026-05-22 14:30]
	- [ ] Draft milestones
	- [x] Collect requirements
- [ ] Write tests #quality [owner: ana] [Docs](https://example.com/docs)
- [ ] Review contract with local attachment

## Doing
- [ ] Implement watcher

## Done
- [x] Create parser

Each card supports:

1. Status with - [ ] and - [x].
2. Inline Markdown links with [Label](https://...).
3. Local attachments with Markdown links to files on your computer, using a path relative to the .md file or a file:///... URL.
4. Optional date/time with [date: YYYY-MM-DD], [date: YYYY-MM-DD HH:mm], [due: YYYY-MM-DD HH:mm], [data: YYYY-MM-DD HH:mm], @YYYY-MM-DD, or @YYYY-MM-DDTHH:mm.
5. Labels with #tag syntax.
6. Assignees with @name, [owner: name], [assignee: name], or [responsavel: name].
7. Subtasks as indented Markdown task items under a card.
8. Drag-and-drop reordering between columns.

Usage

1. Run KanbaCode: Create Board to create a new board.
2. Or run KanbaCode: Open Board to open an existing .md file.
3. Use the board to drag cards, mark them as done, hide completed cards, and open links or local attachments.

All changes are persisted to the .md file.

Local VSIX Test

1. Generate the package with npm run package:vsix.
2. Install it locally with npm run install:vsix.
3. Reload the VS Code window if needed.

Marketplace Publishing

1. Create or confirm the patrick-mns publisher in Visual Studio Marketplace.
2. Generate an Azure DevOps Personal Access Token with Marketplace permissions.
3. Authenticate locally with npx @vscode/vsce login patrick-mns.
4. Compile with npm run compile.
5. Generate the package with npm run package:vsix or publish directly with npm run publish:marketplace.

The package uses the Marketplace metadata defined in package.json: publisher, repository, bugs, homepage, categories, and keywords.