Org-vscode

A fast, keyboard-driven Org Mode–style task manager built for Visual Studio Code. Inspired by Emacs Org Mode

🚀 What is Org-vscode?

Organize your thoughts, tasks, projects, and notes — all inside VSCode — using a minimal Org file format powered by Unicode symbols and intuitive keyboard controls.

Whether you're an Emacs power user or just want a highly structured task system, Org-vscode is built to help you:

• Stay focused
• Schedule your work
• Track task progress
• Visually plan via calendar and agenda views
• Tag tasks/projects
• Search/open files based on tag or title
• Export current active tasks for quick review
• Quickly build tables, checklists, and templates
• Work entirely from the keyboard

🧩 Core Features

Unicode Task States
⊙ TODO, ⊘ IN_PROGRESS, ⊜ CONTINUED, ⊖ DONE, ⊗ ABANDONED

Agenda View
See all scheduled tasks from all .org files in one clean, date-grouped panel. Fully clickable + status toggleable.

Calendar View
Drag & drop tasks to reschedule. Filter by tag. Auto-syncs to file.

Inline Tagging
Use [+TAG:urgent,project] to categorize tasks. Supports AND/OR logic filtering.

Tagged Agenda View
Filter tasks by one or multiple tags, grouped by file. Click-to-edit support.

Table Builder
Visually generate Org-style tables with alignment, row headers, and optional labels.

Align Timestamps
Neatly formats all SCHEDULED: timestamps to the same column width.

Export Active Tasks
Copy all non-DONE tasks to CurrentTasks.org for quick review or reporting.

Year-in-Review Dashboard
Select a full-year Org file, export CSV/JSON summaries, render executive Markdown/HTML, and explore an interactive dashboard with timelines, tag heatmaps, and download buttons directly inside VS Code.

Built-In Snippets
Use /todo, /template, /meeting, /checklist, and more to insert pre-styled blocks.

📊 Yearly Review Workflow

1. Run Org Mode: Export Year Summary to emit year-summary.csv + year-summary.json inside .vscode-orgmode/reports/<year>.
2. Run Org Mode: Generate Executive Report to produce polished Markdown/HTML briefs for leadership updates.
3. Open Org Mode: Open Year-in-Review Dashboard to browse timelines, tag heatmaps, and filterable task lists with quick-open links back to the source file and download buttons for each artifact.

The dashboard reuses the same parser as the exporter, so updates stay in sync and can be regenerated at any time.

Learn More

Full How-To Guide (with examples, images, and keyboard shortcuts): View the Org-vscode How-To →

See recent changes in the CHANGELOG See what’s coming next on the ROADMAP

🔑 Keyboard Shortcuts

📦 Install

Option 1: Marketplace Install

Search for org-vscode in the Extensions Marketplace inside VSCode.

Option 2: Manual Install

Download the latest .vsix from Releases Then: Extensions Panel → More Actions (⋯) → Install from VSIX...

🎬 Demo

Snippets Cheat Sheet

🐞 Issues and Contributions

If you run into a bug or have a feature request, please open an issue.

Pull requests welcome!

👨‍💻 Author

• Maintained by @realDestroyer
• Originally forked from a legacy project by Bobby Boyd — now significantly overhauled with countless new features created from scratch.

📄 License

MIT License — see LICENSE for full details.