justodo — VS Code Extension

Lightweight VS Code extension that adds human-readable IDs (HUIDs) to TODO comments and keeps them synced in a workspace-local JSON store.

Demo (v1.0.3)

v1.0.3.demo.mp4

Features

• Add a unique HUID to the TODO on the current line and record it in .todos/todos.json.
• Mark a TODO as done; the line is removed and the JSON store is updated.
• Search TODOs in the current file via Quick Pick (Ctrl+Shift+8) and jump to any TODO line.
• Language-aware comment symbols for 30+ languages (JS/TS, Python, Go, Rust, HTML, CSS, etc.).
• Workspace-scoped storage so each project keeps its own TODO log.

Requirements

• VS Code ^1.106.1
• Node.js 18+ recommended for tooling (build/test)

Installation

Installation By VS Code Marketplace

Installation link: https://marketplace.visualstudio.com/items?itemName=SamTIme101.justodo

Installation By VSIX

Installation.mp4

Usage

1. Write a TODO comment on any line, e.g. // TODO: handle empty state.
2. Run todos.createTodo (or press Ctrl+Shift+6). The line becomes // TODO<YYYYMMDD-HHMMSS>: handle empty state.
3. To complete it, place the cursor on that line and run todos.markTodo (or Ctrl+Shift+7). The line is removed and the entry is marked done.
4. To browse TODOs in the current file, run todos.searchTodos (or Ctrl+Shift+8), pick one from the Quick Pick list, and the editor jumps to that line.
5. To browse TODOs in all files, run todos.searchAllTodos (or Ctrl+Shift+9), pick one from the Quick Pick list, and the editor jumps to that line.

Storage

• A .todos folder is created at the workspace root with todos.json.
• Entries are grouped by file path and HUID:

  {
      "todos": [
          {
              "path/to/file.ts": {
                  "20251208-161530": {
                      "heading": "handle empty state",
                      "done": false,
                      "line": <line_number>,
                      "createdAt": "2025-12-08T16:15:30.000Z",
                      "markedAt": null
                  }
              }
          }
      ]
  }

Development

• Install deps: npm install
• Build once: npm run compile
• Watch: npm run watch
• Lint: npm run lint
• Type-check: npm run check-types
• Tests (sample): npm test
• Package for release: npm run package (outputs to dist/)

To debug, run the “Extension” launch configuration (F5). This opens a new VS Code window with the extension loaded.

Inspiration

Inspired by Tsoding’s HUID-style TODO workflow: Watch on YouTube

Author

Samip Regmi (samTime101)