Redmine for Positron

Personal workload management for developers using Redmine.

Attribution: This is a Positron-focused fork of vscode-redmine by Tomasz Domański, originally licensed under MIT.

Why This Extension?

Redmine's web UI asks: "How is the PROJECT doing?" — release status, team activity, where time is being spent. It's built for project managers and stakeholders.

This extension asks a different question: "How is MY WORKLOAD doing?"

• What's assigned to me?
• Am I overbooked this week?
• What should I work on next?
• How much time did I log today?

If you're a developer using Redmine, you don't need another project dashboard — you need personal productivity tools integrated into your IDE where you already work.

Why not just use Redmine's web UI?

The web UI is great for project-level oversight, but switching contexts between your IDE and browser breaks flow. This extension keeps your task list, time logging, and timeline right next to your code.

Why not RedmineX or other clients?

Desktop clients like RedmineX replicate Redmine's full project management interface. They're powerful, but they're still project-focused tools. This extension is intentionally focused on your personal workflow — minimal UI, fast actions, IDE integration.

Think of it as: Redmine for you, not Redmine for your project.

Features

• Gantt Chart Timeline
  • Interactive SVG timeline with zoom levels (Day/Week/Month/Quarter/Year)
  • Workload heatmap toggle - shades days by aggregate utilization (green/yellow/orange/red)
  • Per-issue intensity visualization showing daily work distribution
  • Drag handles to adjust start/due dates directly
  • Dependency arrows for issue relations (blocks/precedes/follows)
  • Zoom preserves center view position
  • Undo/redo for date changes
• Quick Time Logging (Ctrl+Y Ctrl+Y)
  • Fast time entry with recent issue cache
  • Flexible time formats: 2.5, 1:45, 1h 45min
  • Optional comment field
  • Status bar confirmation
• Quick Create Issue (Ctrl+Y Ctrl+N)
  • Create issues without leaving IDE
  • Full wizard: project → tracker → priority → subject → description → hours → due date
  • Optional fields skippable via Enter
• Create Sub-Issue (context menu)
  • Right-click any issue → "Create Sub-Issue"
  • Inherits parent's project and tracker
• Sidebar panel
  • List issues assigned to you in sidebar panel
  • List projects and open issues in them
• Create issue (opens redmine create issue in browser)
• List of issues assigned to you
• Open issue by id
• Open issue by selected number in document
• Issue actions:
  • Change status of an issue
  • Add time entry to an issue
  • Open issue in browser
  • Quick update issue

Missing a feature? Open an issue and let me know!

Sidebar panel

Add time entry from action menu

Change server to other workspace folder in sidebar panel

Compatibility

This extension works with both Positron IDE and VS Code.

Requirements

• VS Code 1.106.0+
• Redmine with REST API enabled (/settings?tab=api, requires admin)
• API key from Redmine account (/my/account)

Quick Start

1. Install extension
2. Run: Redmine: Set API Key
3. Enter URL and API key
4. Done!

Security

API keys stored in VS Code Secrets (encrypted, machine-local).

Migrating from v2.x

See Migration Guide.

Extension Settings

This extension contributes the following settings:

• redmine.url: URL of redmine server (eg. https://example.com, http://example.com:8080, https://example.com:8443/redmine, http://example.com/redmine etc.)

• redmine.apiKey: API Key of your redmine account (see /my/account page, on right-hand pane)

• redmine.rejectUnauthorized: Parameter, which is passed to https request options (true/false) (useful to fix issues with self-signed certificates, see issue #3)

• redmine.identifier: If set, this will be the project, to which new issue will be created

  NOTE: this is an identifier of project, not display name of the project

• redmine.additionalHeaders: Object of additional headers to be sent along with every request to redmine server

Development Setup

After cloning:

npm install
npm run install-hooks

Git hooks validate commit messages (subject ≤50 chars, body ≤72 chars).

Contribution

If you want to contribute to the project, please read contributing guide guide.

Known Issues

No known issues yet. If you found one, feel free to open an issue!

Release Notes

See change log

Contributors

This extension builds upon the excellent work of:

• Tomasz Domański (@rozpuszczalny) - Original author
• Doğan Özdoğan - Tree view feature
• Markus Amshove - Quick update feature

Attributions

Original Project

This extension is a fork of vscode-redmine by Tomasz Domański.

Copyright 2018 Tomasz Domański. Licensed under the MIT License.

Logo

Logo is remixed version of original Redmine Logo.

Redmine Logo is Copyright (C) 2009 Martin Herr and is licensed under the Creative Commons Attribution-Share Alike 2.5 Generic license. See http://creativecommons.org/licenses/by-sa/2.5/ for more details.