🛠️ Jirun

Generate JIRA sub-tasks from pre-defined templates — fast, local, and customizable.

✨ Features

• 📁 Init config template files: .jirun.toml and .env
• 🔗 Create defined sub-tasks with prefilled field values
• 🧪 Run with dry-run mode
• 🌍 Support global or local config
• 🔐 Detect and exclude duplicate existing sub-task (simply by summary/title)

🚀 Usage

Usage: jirun <COMMAND>

Commands:
  init      Create .jirun.toml and .env (defaults to the local directory)
  new       Create sub-tasks from [sub_tasks.new_tasks] in .jirun.toml
  template  Create sub-tasks from [sub_tasks.template_tasks]
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

📘 Examples:
  1. jirun help init
     Help menu on initializing jirun's configuration files.

  2. jirun init --global
     Create config files in the global directory.

  3. jirun template --parent PROJ-123
     Use [sub_tasks.template_tasks] to create sub-tasks under PROJ-123

  4. jirun new --parent PROJ-123 --assignee alice
     Use [sub_tasks.new_tasks], overriding assignee with 'alice'

  5. jirun template -p PROJ-123 --dry-run
     Show request payloads without sending to JIRA

📦 Install

cargo install jirun

🧰 Configuration

Run .jirun init --global to generate the config template files.

.jirun.toml:

[server]
url = "https://yourcompany.atlassian.net"

[prefill]
labels = ["cli", "auto"]
assignee = "john.doe"

[sub_tasks]
template_tasks = """
Design API schema
Implement service logic
Write integration tests
"""

new_tasks = """
Fix login bug
Improve error messages
Document usage
"""

.env:

JIRA_TOKEN=your-api-token-here

📄 License

MIT