Redmine CLI

Browse, pin, filter, and update Redmine issues from the VS Code activity bar.

Features

• Browse Redmine projects and issues in a dedicated activity bar view.
• Configure the Redmine server URL and API key from an in-editor setup panel.
• Store API keys in VS Code Secret Storage.
• Filter issues by status, tracker, or current user assignment.
• Pin important issues for quick access.
• Copy issue details and update status/progress without leaving VS Code.

Setup

Run Redmine: Setup from the command palette or the Redmine view title bar. It opens a setup form that stays open while you switch to another app to get configuration values.

Use your direct Redmine server URL:

https://redmine.example.com

Then paste your Redmine API key. The extension stores the key in VS Code Secret Storage and sends it to Redmine as X-Redmine-API-Key, matching redmine_mcp.py.

You can also configure these settings manually:

• redmine-cli.url: direct Redmine server URL
• redmine-cli.apiKey: optional API key fallback for scripted setups
• redmine-cli.headers: optional custom headers formatted as Header1: Value1, Header2: Value2
• redmine-cli.acceptInvalidCerts: allow invalid TLS certificates for trusted self-hosted instances

Requirements

• VS Code 1.85 or newer
• A Redmine instance with REST API enabled
• A Redmine API key for your account

Commands

• Redmine: Setup
• Redmine: Refresh
• Redmine: Filter by Status
• Redmine: Filter by Tracker
• Redmine: My Tasks

Development

npm install
npm run typecheck
npm run compile
npm run package

The extension entrypoint is src/extension.ts; the Redmine API client and task tree provider live under src/services and src/providers.

Publishing notes live in PUBLISHING.md.