Skip to content

Repository files navigation

Build Release Contributors Forks Stars Issues License

Bluemine logo

Bluemine

Opt-in Redmine UX upgrades for teams that want more signal, less friction.

Report Bug · Request Feature · Download Build Artifact

Bluemine is a Manifest V3 browser extension for Chrome and Firefox that enhances Redmine with optional, independently toggleable improvements.

Getting Started

Install

Browser Link
Firefox Firefox Add-ons — Bluemine
Chrome / Edge / Brave Install from the latest GitHub Release (see below)

Install from GitHub Release (Chrome/Edge/Brave)

  1. Download the latest bluemine-extension-<version>.zip from the Releases page.
  2. Extract the ZIP.
  3. Go to chrome://extensions → enable Developer modeLoad unpacked → select the extracted folder.

Install from GitHub Actions (latest build)

  1. Open the Build workflow runs.
  2. Download the latest bluemine-extension-<version>.zip artifact.
  3. Extract the ZIP and load as an unpacked extension:
    • Chrome/Edge/Brave: chrome://extensions → Developer mode → Load unpacked
    • Firefox: about:debugging#/runtime/this-firefox → Load Temporary Add-on → pick manifest.json

No build step required.

Prerequisites

  • Chrome/Edge/Brave or Firefox 121+
  • Access to a Redmine instance
  • Optional: GitLab Personal Access Token for MR integration

Features

Feature What it does
GitLab MR integration Shows merge request status on Agile board cards and issue pages.
Enhanced Agile board Soft-reloads the board in place after actions (preserving scroll), restores collapsed swimlane state across refreshes, and adds a collapse/expand toolbar.
Enhanced Issue edit page Adds small issue edit-page improvements, starting with an Assign random assignee button.
Shift+Hover selection Hold Shift and hover over cards to select them for bulk actions.
Command Palette Keyboard-driven bulk commands on selected cards without leaving the page.
Start Claude Code Adds a button to Agile board cards that opens a deeplink launching Claude Code with the task's title and description.
Fix with Autofix Adds a command palette action that dispatches selected issues to an AI task-runner pipeline.

Command Palette

Press Space while one or more cards are selected (no text input focused). The palette opens with options fetched live from Redmine.

Categories

Category What it does
Status Change status of selected cards
Assignee Reassign selected cards
Tracker Change tracker of selected cards
Target version Set target version of selected cards
Reviewer Set reviewer field
Merged Set merged-by field
Reviewed Set reviewed-by field
Bulk Edit Open the Redmine bulk edit form
Copy Copy selected card IDs to clipboard

Keyboard shortcuts

Status abbreviations — type to jump directly to a status:

Shortcut Status
cl Closed
new New
ip In Progress
rs Resolved
fb Feedback
rj Rejected
oh On Hold
co Confirmed

Category prefixes — type to filter to a category, then add a space and continue typing to filter by name within it:

Prefix Category
as Assignee
re Reviewer
tr Tracker
tv Target version
mg Merged
rd Reviewed

Person name abbreviation — first letter of first name + first letter of last name + last letter of last name:

  • "Anna Berg" → abg
  • "Erik Holm" → ehm

Works standalone or after a category prefix (e.g. as mak). Abbreviation matches rank above substring and fuzzy matches.

Navigation

Key Action
↑ / ↓ Navigate the list
Tab Queue the highlighted command as a chip
Enter Execute the highlighted command (or all queued chips at once)
Backspace Remove last queued chip (when input is empty)
Escape Close without executing

Batch mode

Tab queues commands as chips. Multiple commands from different categories are merged into a single request on Enter. Each category allows only one chip at a time — queuing a second command in the same category replaces the first. Bulk Edit and Copy IDs cannot be chained with other commands.

Configuration

Open the extension popup to configure:

  • Feature toggles (GitLab MR, Enhanced Agile board, Enhanced Issue edit page, Shift+Hover, Command Palette, Start Claude Code, Fix with Autofix)

  • GitLab Base URL (https://gitlab.example.com)

  • GitLab API Key (glpat-...)

  • Project mapping: one redmine-project-slug=gitlab_project_id per line

  • Command Palette: Copy IDs separator (default: &)

  • Start Claude Code: builds a Claude Code deep link (claude-cli://open) from simple fields — no URL to hand-write:

    • Project folders — one redmine-project-slug=/local/path per line. The folder for the current board's project becomes the session's working directory; unmapped projects open in your home directory.
    • Prompt prefix (optional) — text added before the task's title and description

    The task's title and description always fill the prompt (capped at 5,000 characters). Requires Claude Code v2.1.91+, which registers the claude-cli:// handler on first run.

  • Fix with Autofix: pipeline execution URL (https://gitlab.example.com/api/v4/projects/350/trigger/pipeline) and AI Task Runner pipeline access token. The Redmine project slug is taken from the board URL.

Permissions and Privacy

Permission Purpose
storage Persist feature toggles and settings locally
activeTab Operate on the current tab
host_permissions (http://*/*, https://*/*) Support self-hosted Redmine and GitLab instances

No analytics or telemetry. External network calls are limited to the configured GitLab API (when enabled) and the GitHub Releases API (popup update indicator).

Build and Release

CI via GitHub Actions (workflow):

  • Triggered on push, v* tags, and manual dispatch.
  • Packages the repository and uploads bluemine-extension-<version>.zip as a workflow artifact.
  • On tagged commits at main HEAD, also creates a GitHub Release with the ZIP attached and auto-generated release notes (commit messages since the previous tag).

License

Distributed under the MIT License. See LICENSE.

(back to top)

About

A chrome extension that improves the lives of developers every day.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages