ToDo Engineer
ToDo Engineer turns code comments into assigned, date-aware tasks. It gives you a personal task view in the VS Code Activity Bar, highlights expiring work, and can create a linked GitHub issue from a TODO.
Developed by Ayus Paudel.
Features
- Adds a ToDo Engineer icon to the left Activity Bar.
- Shows tasks assigned to your GitHub username in My ToDos.
- Groups tasks into Overdue, Due Today, Upcoming, and No Due Date.
- Highlights overdue tasks red and tasks due today amber in the editor.
- Creates portable TODO comments with an assignee, priority, and optional due date.
- Uses configured team members offline, or fetches valid GitHub issue assignees for the current repository after sign-in.
- Creates GitHub issues from TODOs and records the issue number in the source comment.
Create a TODO
Right-click in an editor and choose ToDo Engineer: Create Assigned TODO. Choose an assignee, priority, and due date.
The extension writes a normal comment in the current language, for example:
// TODO(@octocat) [priority:high] [due:2026-07-01]: Handle expired token refresh
# TODO(@octocat) [priority:medium] [due:2026-07-01]: Add retry handling
Tasks can also be written manually. The required format is:
TODO(@github-user) [priority:low|medium|high|urgent] [due:YYYY-MM-DD]: Task description
The assignee and due-date sections are optional. To link an existing issue, add [issue:#123] before the colon.
See tasks assigned to you
- Click the ToDo Engineer icon in the left Activity Bar.
- Click the account icon in the view title, or run ToDo Engineer: Set My GitHub Username.
- Enter your GitHub username without
@.
The view now shows only tasks containing TODO(@your-username). Use the tree/list icon to toggle between your tasks and all workspace tasks.
GitHub issues
Open a Git repository with a GitHub origin remote. Right-click a ToDo Engineer TODO and choose ToDo Engineer: Create GitHub Issue. VS Code asks you to sign in to GitHub and confirm the issue creation. The task’s assignee, title, priority, and due date are sent to GitHub.
ToDo Engineer requires permission from the signed-in GitHub account and only offers GitHub assignees that the repository allows. For repositories without GitHub access, add usernames to the todoEngineer.teamMembers setting.
Settings
todoEngineer.githubUsername: Your GitHub username used by the My ToDos view.
todoEngineer.teamMembers: Optional GitHub usernames used as offline assignee suggestions.
Requirements
Visual Studio Code 1.80.0 or newer. GitHub issue integration also requires the built-in Git extension, a GitHub remote, and GitHub sign-in.
License
ToDo Engineer is released under the MIT License. The full text is included in the extension's LICENSE file.