A small terminal CLI for managing Redmine issues from the command line.

Bootstrap the toolchain (one-time, installs the Python and uv versions pinned in mise.toml):

mise install

Install rmk globally:

uv tool install .

Or for development (uses the local virtualenv):

uv sync --all-extras --group dev
uv run rmk --help

Copy .env.example to .env and fill in your Redmine API key:

cp .env.example .env
$EDITOR .env

You can find your API key in Redmine under Account → API access key.

List issues assigned to you (open / in-progress / reopened, most recent first).

rmk list
rmk list --limit 50
rmk list --status 1,2,4,5

Show full issue details. If the issue has image attachments, you'll be prompted to download and open them in your default image viewer.

rmk show 1234

Downloaded images are saved to ./images/<issue_id>_<filename>.

Assign an issue to yourself. Status unchanged.

Set an issue to In Progress. Assignee unchanged.

Set an issue to Open. Assignee unchanged.

Mark an issue Resolved and reassign it back to its original author.

Mark an issue Rejected and reassign it back to its original author.

mise install                      # tool versions (one-time)
uv sync --all-extras --group dev  # python deps
uv run pytest                     # tests
uv run ruff check .               # lint
uv run black --check .            # format check
uv run isort --check-only .       # import order check

CI runs all of the above on every push and pull request.