jira-cli

CLI em Go para interagir com o Jira Cloud via REST API v3.

Pré-requisitos

• Go 1.21+ instalado e configurado no PATH

Instalação

macOS / Linux

# Build local
make build
./bin/jira --help

# Instala no $GOPATH/bin (disponível globalmente)
make install

Windows

O make não é nativo no Windows. Use o comando Go diretamente:

# Build local
go build -o bin\jira.exe .\cmd\jira
.\bin\jira.exe --help

# Instala no %USERPROFILE%\go\bin (disponível globalmente)
go install .\cmd\jira

Certifique-se de que %USERPROFILE%\go\bin está no seu PATH.

Setup

jira config init
# ou para um perfil específico:
jira config init --profile client-x

O arquivo de configuração fica em ~/.jira-cli/config.yaml.

Exemplo de config.yaml

default_profile: work

profiles:
  work:
    base_url: https://work.atlassian.net
    email: you@work.com
    api_token: SEU_TOKEN_AQUI
    default_project_key: WORK
    default_issue_type: Task
  client-x:
    base_url: https://clientx.atlassian.net
    email: you@clientx.com
    api_token: OUTRO_TOKEN
    default_project_key: CX
    default_issue_type: Story

Gere seu API token em: https://id.atlassian.com/manage-profile/security/api-tokens

Uso

Trocar de perfil

# Via flag (sessão única)
jira --profile client-x issue create --summary "Bug"

# Via variável de ambiente (sessão do shell)
export JIRA_PROFILE=client-x
jira issue create --summary "Bug"

Criar uma issue

jira issue create --summary "Título da task"
jira issue create --summary "Bug no login" --description "Detalhes..." --project PROJ --type Bug

Atualizar descrição

jira issue describe PROJ-123 --description "Nova descrição"

Mudar status

jira issue transition PROJ-123 --status "In Progress"

Adicionar comentário

jira issue comment PROJ-123 --body "Comentário via CLI"

Saída JSON

Adicione --json a qualquer comando para saída estruturada:

jira --json issue create --summary "Bug" | jq .data.issue_key

Listar perfis

jira config list
jira --json config list

Variáveis de ambiente

Variável	Descrição
JIRA_PROFILE	Perfil ativo (sobrescreve default_profile)
JIRA_BASE_URL	URL base do Jira (sobrescreve o perfil)
JIRA_EMAIL	Email Atlassian (sobrescreve o perfil)
JIRA_API_TOKEN	API token (sobrescreve o perfil)
JIRA_PROJECT	Project key padrão (sobrescreve o perfil)

Exit codes

Código	Significado
0	Sucesso
1	Erro geral / API error
2	Input inválido
3	Autenticação falhou (401/403)
4	Recurso não encontrado (404)

Build para distribuição

make build-all
# gera binários em bin/ para Darwin (arm64/amd64), Linux e Windows