Welcome to Jirafs’s documentation!

Pronounced like ‘giraffes’, but totally unrelated to wildlife, this library lets you stay out of Jira as much as possible by letting you edit your Jira issues as a collection of text files using an interface inspired by git and hg.

• Getting Started
  • Installation
  • Working with a Jira issue
  • Editing Issue Fields
  • Adding, Removing or Changing Links
    • Issue Links
    • Remote Links
  • Macros
• Migrating from 1.0
• Common Commands
  • clone <source>
  • preview <field name>
  • submit
  • commit
  • pull *
  • push *
  • status *
  • open *
  • subtask <summary>
  • assign [<username>]
  • transition
• Advanced Commands
  • fetch
  • merge
  • diff
  • field <field name>
  • setfield <field name> <value>
  • match <field name> <value>
  • log
  • config
  • plugins
  • git
  • debug
  • search_users <term>
  • create
• Configuration
  • Using an untrusted HTTPS certificate
  • Disabling “Save Jira Password” prompt
  • Setting a Date Format for Rendered Comments
• Using Plugins
  • Writing your own Plugins
    • Writing Plugins
    • Writing Command Plugins
• Using Macros
  • Existing Macros
  • Writing your own Macros
• Interesting Details
  • Ignore File Format
  • Directory Structure
  • VIM Plugin