Dev Crumbs
Never lose your train of thought. Leave yourself breadcrumbs of context directly in your workspace.
✨ Overview
Dev Crumbs is a Visual Studio Code extension designed for developers who frequently switch contexts, need to jot down quick thoughts, or want to maintain a work log without leaving their editor.
It helps you track tasks, notes, and your working state — all stored locally and transparently within your project directory.
📸 Screenshots
Dev Crumbs Sidebar View (with contextual TODOs decorations in the editor)
All Commands in the Command Palette
🚀 Features
- 📝 Project Journal – Keep a running log of your development journey. Create new entries from templates to document progress, decisions, and discoveries.
- ✅ Contextual TODOs & Notes – Pin TODOs and notes directly to lines of code. A decoration appears in the file itself, reminding you of the task or thought associated with that location.
- ⏸️ Pause & Resume Context – Seamlessly switch between tasks:
- Pause Context: Saves your current working state (open files, Git branch, and a custom note) into a
CURRENT_CONTEXT.md.
- Resume Context: Re-opens your saved context and optionally restores all previously open files.
- 📂 Sidebar View – Manage all your journal entries, TODOs, and contextual notes from a dedicated sidebar, giving you a clear overview of all your crumbs.
- 📦 Local First – All data is stored locally in a configurable crumbs directory (
.devcrumbs by default) at the root of your workspace.
- 🔒 Git Friendly – The
.devcrumbs directory is automatically added to your .gitignore to prevent accidental commits.
🏁 Getting Started
Click the Dev Crumbs icon in the Activity Bar to open the sidebar.
Use the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) to access main commands:
Dev Crumbs: New Journal EntryDev Crumbs: Add TODODev Crumbs: Pause ContextDev Crumbs: Resume Context
To add a note or TODO to a specific line, right-click in the editor and select Add Note Here or Add TODO Here.
(Tip: When no workspace is open, Dev Crumbs shows a simple placeholder message guiding you to start by opening a folder.)
⚙️ Extension Settings
| Setting |
Type |
Default |
Description |
devCrumbs.crumbsDirectory |
string |
.devcrumbs |
Directory where Dev Crumbs are stored, relative to the workspace root. |
devCrumbs.autoIgnore |
boolean |
true |
Automatically add the crumbs directory to .gitignore if it exists. |
⌨️ Default Keybindings
| Command |
Windows/Linux |
macOS |
New Journal Entry |
ctrl+shift+j |
cmd+shift+j |
Add TODO |
ctrl+shift+t |
cmd+shift+t |
Add Note Here |
ctrl+shift+alt+n |
cmd+shift+alt+n |
Add TODO Here |
ctrl+shift+alt+t |
cmd+shift+alt+t |
📦 Release Notes
0.1.0
Initial release of Dev Crumbs.
- Journaling, Contextual Notes, and TODOs.
- Context Pause/Resume functionality.
- Automatic
.gitignore handling.
📜 Changelog
To check the complete changelog click here
🙌 Feedback & Contributions
If you encounter issues or have feature requests, please open an issue.
📋 License
This extension is licensed under the MIT LicenseMIT
