Projects TODO Advanced

Projects TODO Advanced is a structured TODO sidebar for VS Code with standalone lists, nested folders, quick task entry, drag and drop, and native view menu actions.

It is built for people who want project task management directly in the editor instead of another app or TODO comments scattered across files.

What It Does

• Create standalone TODO lists and show only selected lists in the current workspace
• Organize tasks into nested folders
• Add tasks quickly with inline inputs at the bottom of lists and folders
• Drag tasks and folders between lists and folders
• Rename tasks, folders, and lists inline from hover actions
• Import and export all lists or a single list
• Clean up completed tasks automatically after a configurable retention period
• Use VS Code native view actions for visibility, retention, import/export, and list creation
• Keep local storage as the default, or sync private lists to a personal GitHub repository and move selected lists into named GitHub workspaces
• Sign in with GitHub through Supabase and safely migrate existing local and GitHub data

Screenshots

Overview

Drag And Drop

Import / Export

Main Workflows

1. Build lists for each project area

Create separate lists for backend, frontend, bugs, release prep, or imported planning notes.

2. Show only relevant lists in each workspace

Use the native ... menu in the view title and open Workspace Visibility... to choose which lists are visible in the current workspace.

3. Add tasks fast

Hover a list or folder and use the inline quick-add input at the bottom of its content.

4. Reorganize by drag and drop

Move tasks or whole folders into another list or nested folder using the drag handle.

5. Keep done items for a limited time

Set Completed Retention... from the native menu to keep completed tasks for 1, 3, 8, 14, 30, or 90 days.

6. Keep local data or sync to GitHub

Use Storage Mode... to choose one of these options:

• Keep local storage
• Enable GitHub Sync
• Back to Local Mode

GitHub Sync creates or reuses a private personal repository for your own lists and keeps local data as a safe working copy. Workspace lists are moved into named workspace repositories that the extension creates automatically through the signed-in VS Code GitHub account if needed. The mode switch never deletes or overwrites local data.

7. Migrate existing data to Supabase

After the update, the extension displays a one-time migration prompt and keeps a migration banner in the TODO sidebar until the transfer succeeds. Choose Migrate now (or click Migrate in the sidebar), finish GitHub sign-in in the browser, and the migration continues automatically when VS Code regains focus.

You can also start the same flow manually with TODO: Migrate Data to Supabase.

The migration:

• creates a local JSON backup before uploading data
• imports local and personal GitHub lists without deleting their original copies
• is idempotent, so it can be safely repeated
• lets each GitHub repository owner migrate a workspace and creates invitations for its collaborators
• lets collaborators accept migrated workspace access when they run the migration after signing in

If a collaborator runs the migration before the repository owner, that workspace is reported as deferred and can be picked up on a later run.

Native View Menu

The view title ... menu includes:

• Create List
• Workspace Visibility...
• Completed Retention...
• Export All
• Export Single List...
• Import

Import / Export Format

The extension uses JSON for import and export:

{
  "version": 2,
  "exportedAt": "2026-04-02T12:00:00.000Z",
  "entries": [
    {
      "list": {
        "id": "list-example",
        "name": "Release",
        "createdAt": 1712059200000,
        "store": {
          "groups": [],
          "todos": []
        }
      }
    }
  ]
}

Run In Development

1. npm install
2. npm run compile
3. Press F5 in VS Code
4. Open the TODO activity bar icon in the Extension Development Host

Supabase Development

Database changes are stored as versioned SQL files in supabase/migrations.

npx supabase link --project-ref hvtmzmifjtpcsrpzochy
npx supabase db push --dry-run
npx supabase db push

The extension contains only the Supabase project URL and publishable key. Never add a Supabase secret/service-role key, database password, personal access token, or GitHub OAuth client secret to the repository.

Packaging

vsce package