Ticketron (tix)
About
Ticketron (tix) is a CLI tool designed to quickly create JIRA issues based on brief user input, leveraging LLMs for detail generation and an MCP server for JIRA interaction.
Details
- License
- MIT license
Explore
Create JIRA issues using natural language (tix create ...)
Search JIRA issues using JQL (tix search ...)
Contextual ticket generation via LLM (using OpenAI)
Configuration management (tix config init|show|locate|set-key)
Secure API key storage (OS Keychain or Env Var)
LLM Context management (tix context show|edit|add)
Shell completion support (Bash, Zsh, Fish, PowerShell)
Structured output formats (JSON, YAML, TSV)
- Structured logging for easier debugging
Go: Version 1.23.8 or later.
jira-mcp-server: Access to a running instance of the jira-mcp-server (required for JIRA communication).
OpenAI API Key: Required for the LLM features.
Make: Required for development tasks (building, testing, linting).
go install github.com/karolswdev/ticketron/cmd/tix@latest
$GOPATH/bin or $HOME/go/bin is in your PATH.
Key configuration files found in ~/.ticketron/:
config.yaml: Main configuration.
mcp_server.url: URL of your running jira-mcp-server.
Other settings like default project, issue type, logging level.
Note: The openai.api_key is no longer stored here.
links.yaml: Maps short project aliases to full JIRA project keys and default issue types.
Example:
links:
- name: WEB
key: WEBPROJECT
default_issue_type: Story
- name: API
key: BACKENDAPI
default_issue_type: Task
- name: DS
key: DATASCIENCE
default_issue_type: Bug
system_prompt.txt: Contains the system prompt used to instruct the LLM during ticket creation. Modify this to tailor the LLM's behavior.context.md: Provides persistent context to the LLM about your projects, team, or common ticket patterns.
Use tix config show to view the current configuration (excluding the API key) and tix config locate to find the configuration directory.
Use tix --version to display the application version.
```bash
tix config init
tix config show
tix config locate
A smart CLI helper for JIRA, powered by LLMs.
Elevator Pitch
Ticketron (tix) simplifies interacting with JIRA directly from your command line. Leveraging the power of Large Language Models (LLMs) via the jira-mcp-server and OpenAI, it allows you to create and search for JIRA tickets using natural language or concise commands. The primary goal is to streamline your workflow, making ticket management faster and more intuitive by automatically adding relevant context.
Features
Create JIRA issues using natural language (tix create ...)
Search JIRA issues using JQL (tix search ...)
Contextual ticket generation via LLM (using OpenAI)
Configuration management (tix config init|show|locate|set-key)
Secure API key storage (OS Keychain or Env Var)
LLM Context management (tix context show|edit|add)
Shell completion support (Bash, Zsh, Fish, PowerShell)
Structured output formats (JSON, YAML, TSV)
Structured logging for easier debugging
Installation
Prerequisites
Go: Version 1.23.8 or later.
jira-mcp-server: Access to a running instance of the jira-mcp-server (required for JIRA communication).
OpenAI API Key: Required for the LLM features.
- Make: Required for development tasks (building, testing, linting).
Install Command
go install github.com/karolswdev/ticketron/cmd/tix@latest
$GOPATH/bin or $HOME/go/bin is in your PATH.
Shell Completion
tix supports generating shell completion scripts for Bash, Zsh, Fish, and PowerShell.
To generate the script for your shell, use the completion command:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
