rmine

README

rmine

A command-line client for Redmine — issues, projects, and time logging, without leaving the terminal. Supports multiple Redmine servers via named profiles.

Install

Download a binary from the Releases page, or build from source:

go install github.com/mehboobali98/rmine/cmd/rmine@latest

go install puts the binary in $(go env GOPATH)/bin (usually ~/go/bin) — make sure that's on your PATH.

Uninstall

rm "$(go env GOPATH)/bin/rmine"
rm -rf ~/.config/rmine   # also drop saved profiles/API keys

Getting started

rmine config init

You'll be asked for your Redmine server URL and a personal API key (found under My account → API access key in Redmine). This saves a default profile and verifies it works.

rmine whoami
rmine project list
rmine issue list --project myproject --status open
rmine time log 1234 --hours 1.5 --activity Development --comment "Fixed the login bug"

Multiple servers

rmine config add-profile work
rmine config use-profile work        # switch persistently
rmine --profile work issue list      # or override for one command
RMINE_PROFILE=work rmine issue list    # or via env var
rmine config list-profiles

Commands

Command	Description
rmine whoami	Show the user for the active profile's API key
rmine project list / view <id>	Browse projects
rmine issue list	List issues (--project, --status, --assignee, --tracker, --subject, --updated-after, --updated-before, --limit, --all)
rmine issue view <id>	Show issue details
rmine issue create	Create an issue (--project, --subject required; --description, --tracker, --priority, --assignee)
rmine issue update <id>	Edit an issue
rmine issue close <id>	Close an issue (--status to pick a specific closed status)
rmine issue comment <id> <note>	Add a comment
rmine time log <issue-id>	Log time (--hours required; --date, --activity, --comment)
rmine time list	List time entries (--issue, --project, --user, --from, --to)
rmine time edit <id>	Edit a time entry
rmine time delete <id>	Delete a time entry (prompts unless -y/--force)
rmine config init / add-profile / use-profile / list-profiles	Manage server profiles

Every command accepts -o json for scripting-friendly output, and --profile <name> to target a specific server for that one call.

Assignees are set/filtered by numeric Redmine user ID (or the literal me); looking other users up by name isn't in scope yet.

--subject (and combining it with other filters) uses Redmine's advanced filter syntax under the hood, which doesn't default to open-only issues the way the plain filters do — expect closed issues in the results too unless you also pass --status open.

Shell completion is available via rmine completion bash|zsh|fish (see rmine completion --help for setup instructions).

Development

go build ./...
go vet ./...
go test ./...

Releases are cut with goreleaser on tag push (see .github/workflows/release.yml).