Monton App - VSCode/Cursor Extension
Connect to Monton directly from VSCode or Cursor to view your projects, phases, and tasks.
Features
- 🔐 Secure Authentication: Connect using Personal Access Tokens stored securely
- 📁 Project Browser: View all your projects in a tree view
- 📋 Phase Navigation: Browse phases within each project
- ✅ Task Overview: See tasks with status, priority, and assignee info
- 🔍 Task Filtering: Filter tasks by status or name to find what you need
- ⏱️ Time Tracking: Log time entries and use a built-in timer for tasks
- 🔄 Real-time Refresh: Keep your data up-to-date with manual refresh
Getting Started
1. Create a Personal Access Token
- Log into Monton
- Navigate to User Settings → Access Tokens
- Click Create Token
- Enter a name (e.g., "VSCode Extension")
- Copy the token immediately - it's only shown once!
2. Connect the Extension
- Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P)
- Run "Monton: Connect with Personal Access Token"
- Paste your token when prompted
- You're connected! 🎉
3. Browse Your Projects
- Click the Monton icon in the Activity Bar (left sidebar)
- Expand projects to see phases
- Expand phases to see tasks
- Hover over items for detailed information
4. Track Time on Tasks
Right-click on any task and select "Track Time Entry" to open the time tracking panel.
Manual Time Entry
- Select a date (defaults to today)
- Enter hours manually or use quick shortcuts:
1h, 4h, 8h
- Optionally mark as Extra/Overtime hours
- Click "Add Time" to save the entry
Timer (Start/Stop)
- Click "▶️ Start Timer" to begin tracking time
- Work on your task while the timer runs
- Click "⏹️ Stop & Save" to save the recorded time
- Or click "❌ Cancel" to discard the timer without saving
5. Filter Tasks
Use the filter buttons in the Projects view toolbar to quickly find the tasks you need.
Filter by Status
Click the filter icon (🔍) to filter tasks by status:
| Status |
Description |
| Only Active (default) |
Shows all tasks except Finished and Cancelled |
| All Statuses |
Shows all tasks regardless of status |
| PENDING |
Tasks not yet started |
| IN PROGRESS |
Tasks currently being worked on |
| ON HOLD |
Tasks temporarily paused |
| BLOCKED |
Tasks blocked by dependencies |
| TESTING |
Tasks in testing/review |
| FINISHED |
Completed tasks |
| CANCELLED |
Cancelled tasks |
Filter by Name
Click the search icon (🔎) to filter tasks by name. Enter any text to show only tasks whose names contain that text (case-insensitive).
Clear Filters
When filters are active (other than the default "Only Active"), a clear icon appears. Click it to reset all filters to defaults.
Commands
| Command |
Description |
Monton: Connect with Personal Access Token |
Connect to Monton with your PAT |
Monton: Disconnect |
Disconnect and clear stored credentials |
Monton: Refresh Projects |
Refresh all project data |
Monton: Filter Tasks by Status |
Filter tasks by their status |
Monton: Filter Tasks by Name |
Filter tasks by name text |
Monton: Clear Task Filters |
Reset filters to defaults |
Track Time Entry |
Open time tracking panel for a task (right-click context menu) |
Security
- Your Personal Access Token is stored securely using VSCode's SecretStorage API
- The token is never logged or exposed in settings
- All API communication is over HTTPS
- You can revoke tokens at any time from Monton's web interface
Requirements
- VSCode 1.85.0 or higher
- A Monton account with a Personal Access Token
License
MIT License - see LICENSE for details.
Support
For issues and feature requests, please visit the monton.app
| |
