Quick Start

First-time setup

1. Run the login wizard and point it at your Redmine server:

   redmine auth login

2. Confirm you are wired up:

   redmine auth status

3. Start driving issues, time entries, and more.

Issues

List

redmine issues list --project myproject
redmine issues list --assignee me --status open

View

redmine issues get 123

Create

redmine issues create \
  --project myproject \
  --subject "Fix login bug" \
  --tracker Bug

Update

redmine issues update 123 --status "In Progress" --assignee me

Close

redmine issues close 123 --notes "Fixed in commit abc123"

Browse

redmine issues browse --project myproject

Time tracking

# interactive
redmine time log

# one-shot
redmine time log --issue 123 --hours 2.5 --activity Development --comment "Code review"

# today's entries
redmine time list --user me --from today

Search

redmine search "login bug"
redmine search issues "login bug" --project myproject
redmine search "login bug" --open-issues

Name resolution

no IDs required

You do not need to memorise numeric IDs. The CLI resolves trackers, statuses, priorities, projects, and users by name.

redmine issues create \
  --project myproject \
  --tracker Bug \
  --priority High \
  --assignee "John Smith"

redmine issues list --assignee me

The `me` keyword

me always resolves to the current user of the active profile — handy in scripts that run under different accounts.

Output formats

redmine issues list          # table (default)
redmine issues list -o json  # machine-readable output
redmine issues list -o json  # scripting
redmine issues list -o csv   # spreadsheets

Where next

Issues reference Every flag on every issue subcommand.

Time reference Full time-tracking surface.

Output formats Tips for scripting with JSON and CSV.

AI agent integration Wire the CLI into Claude Code, Cursor, etc.