Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Redmine command-line client
Branch: master

reads protocol out of keychain

Previously hardcoded http.
latest commit 7d4472c8e3
@jeremy-w authored
Failed to load latest commit information.
bin reads protocol out of keychain
lib reads protocol out of keychain
.gitignore First post! WHOOSH!
README.markdown adds Setup section to README




Redminer is a commandline interface to the Redmine API. The Redmine API is limited in scope, and so is this tool.


I needed an easy way to post time entries to Redmine.

Why Not

Redminer is held together with spit and baling wire. It works for me, but I don't like it. I recommend against adopting it at this time.

Nevertheless, if you're looking for a commandline interface to Redmine, here you go.


  • List recent time entries
  • Search back a bit to find recent time entries owned by you
  • Add a new time entry
  • List your user info
  • List projects
  • List issues
  • Fetch issue by id -- useful for making sure you've got the right id when you go to add time to it.


Redminer depends on the OS X keychain for storage of your login info, and on your sufferance for its continued existence. It begs a thousand pardons that it should be so ugly and yet live.


Add a new Internet password named "redmine" with the correct host. Add "api: <yourkey>" to the comments field.


  • Choose File > New Password, or just hit Cmd-N.

    • First field is the web address of your Redmine host (include the http:// or https:// part).
    • Second field is your Redmine username.
    • Third field is your Redmine account password.
    • Now add the password entry to the Keychain using the button in the lower right.
  • Now double-click to edit the password:

    • Change the name to just "redmine".
    • In the Comments field, put "api: 1234…abcd", replacing the part after "api: " with your API key.


  • Non-fugly user interface. (YAML hash dump? Really?)
  • An actual user interface supporting flags and some flexibility, not one that barely works.
  • Custom printers for issues and such. Leave dumping the whole object tree to --debug or something like that.
  • Maybe expose some more of the Redmine API. Maybe.
Something went wrong with that request. Please try again.