Taskmark

Product memory for agent work

Setup

Install and first board

Add the plugin in Cursor, then initialize a Taskmark board in your workspace.

Install the plugin

  1. Open Customize → Plugins.
  2. Remove any broken taskmark entry first.
  3. Add local → select the taskmark-cursor repo root (the folder that contains .cursor-plugin/marketplace.json).
  4. Enable taskmark, then run Developer: Reload Window.

After layout changes in the plugin package, commit before re-adding (Cursor packages from git). Clear stale caches if the marketplace entry looks broken.

Initialize a board

  1. Install the plugin (above).
  2. Run /tkmd-init in a product workspace.
  3. Run /tkmd-verify on an older board to repair scaffold, delete leftover generated files, and strip legacy item markdown (never commits)
  4. Single git project: board lives at <project>/taskmark/.
  5. Multiple git projects: board lives at a sibling <common>-taskmark repo root (flat — no nested taskmark/).

The board is never copied into every product repo. REPOS.md is generated locally, gitignored, and lists linked roots with machine paths — it is not pushed.

First commands

  1. /tkmd-verify — migrate an existing board to the current layout (scaffold like init, delete leftover generated files, strip legacy markdown). Never commits; /tkmd-commit remains the only commit command
  2. /tkmd-plan — fit an epic, story, task/bug, or full tree to existing board work from prose (creates items only)
  3. /tkmd-save — after Cursor Plan mode, turn that plan into board items and keep diagrams/visuals on them
  4. /tkmd-save-do — same save as /tkmd-save, then implement the newly created items immediately (never commits)
  5. /tkmd-plan-do — same planning as /tkmd-plan, then implement the newly created items immediately (never commits)
  6. /tkmd-do — implement existing targets; leaves you finished become done (no commit, no in_progress)
  7. /tkmd-shelf — discard planned work that will never be implemented; eligible leaves become shelved without a commit
  8. /tkmd-changelog — rebuild Unreleased notes in board CHANGELOG.md from recent done work
  9. /tkmd-version — promote Unreleased into a dated version and set that SemVer on every linked product
  10. /tkmd-reportme — write a personal report of my done work since the last report into gitignored .reports/
  11. /tkmd-commit — commit linked repos when you are ready

Open the local board

The board UI is @taskmark/ui. Bound mode opens the board found in or near the current directory (a nested taskmark/ folder, or a flat *-taskmark root). Workspace mode (npx @taskmark/ui with no nearby board, or taskmark open / --workspace) shows a setup wizard and project picker.

# inside a board folder
npx taskmark serve

# no local board nearby
npx @taskmark/ui

Prefer npx @taskmark/ui when the package is not installed locally — a different npm package owns the bare taskmark name. Details live in the taskmark-frontend README.

Next: Commands reference and folder structure.