⚓ DevTodo: The Ultimate Code-Aware Task Manager

Tired of context switching? Hate when you write a task in Jira or Todoist, only to forget exactly which file and which line of code it belonged to?

DevTodo is a blazing-fast, code-aware productivity hub built directly into your VS Code sidebar. It doesn't just store text; it physically links your tasks to your actual code.

✨ Why DevTodo?

1. ⚓ Indestructible Code Anchors

Highlight any block of code, right-click, and select "Todo: Create Task from Code". DevTodo saves a secure "fingerprint" of that code. Even if you add 100 lines of code above it, or refactor the file, clicking the "Jump to Code" arrow in your sidebar will intelligently find where the code moved to and scroll you right to it!

2. 🕵️‍♂️ Auto-Scanner

Already have // TODO: or # TODO: comments scattered across your project? Click the Sync button in the DevTodo sidebar. It instantly and safely scans your workspace (ignoring heavy folders like node_modules and .git), and pulls every TODO comment into a beautiful UI list.

3. 🪄 Interactive CodeLens

Whenever you type // TODO: Fix this bug in your editor, a faint, clickable [ ✅ Complete TODO ] button magically appears right above it. Click it, and DevTodo safely rewrites the code to // DONE: Fix this bug without messing up your Ctrl+Z undo history.

4. 🤝 Git-Shareable (No Jira Required)

Your tasks aren't hidden in a secret database. They are saved directly into your project inside a .vscode/devtodo.json file. Commit this file to GitHub, and your entire team instantly shares the same To-Do list the moment they pull the repo!

🚀 How to Use It (Working Procedure)

📝 Adding a Quick Task

1. Click the Checklist Icon on your far-left activity bar to open DevTodo.
2. Click the + icon at the top (or use the Command Palette: Todo: Add Task).
3. Type your task and hit Enter.

🔗 Anchoring a Task to Code (The Magic)

1. Highlight 1 to 5 lines of code in any file.
2. Right-click the highlighted code.
3. Select Todo: Create Task from Code and give it a name.
4. Later, click the Arrow Icon (->) next to the task in your sidebar to instantly jump back to that exact code!

✔️ Completing Tasks

• Toggle: Click the o icon next to any task in the sidebar to mark it as a green completed checkmark. Click it again to undo.
• Delete: Hover over a task and click the 🗑️ Trash Can icon to remove it permanently.
• Status Bar: Keep an eye on your bottom-right status bar to see a live count of your Pending and Completed tasks!

🗺️ Roadmap (Upcoming Features)

We are actively building the ultimate developer workflow. Coming soon:

• Git-Branch Awareness: Automatically hide tasks that don't belong to the Git branch you are currently working on.
• Kanban Board UI: Open a full-screen, drag-and-drop Kanban board for heavy project management.
• Global Personal Tasks: A separate list for personal tasks that follow you across every VS Code window you open.

❤️ Feedback & Contributions

Built by developers, for developers. If you find a bug or have a feature request, please feel free to open an issue on our GitHub repository (link coming soon!).

Happy Coding! ☕💻