linear_client

Cliente Ruby puro para a API GraphQL do Linear — sem gems externas, apenas a stdlib (net/http, uri, json).

Não há SDK oficial para Ruby; este projeto preenche essa lacuna com uma interface simples para criar issues, comentar e consultar dados no Linear.

gem install linear_client

ou no Gemfile:

gem "linear_client"

1. Gere uma API key pessoal no Linear em Settings > Account > Security > API keys.
2. Exporte a chave como variável de ambiente (nunca hardcode no código):

export LINEAR_API_KEY="lin_api_xxxxxxxx"

Trate a API key como uma senha: não a compartilhe, não a commit em arquivos versionados, e revogue/gere outra se ela vazar.

require "linear_client"

client = LinearClient::Client.new
# ou, explicitamente:
client = LinearClient::Client.new(api_key: "lin_api_xxxxxxxx")

client.teams
# => [{"id"=>"...", "name"=>"Engineering", "key"=>"ENG"}, ...]

result = client.create_issue(team_id: "TEAM_ID", title: "Bug no login", description: "Detalhes...")
issue_id = result.dig("issue", "id")

client.create_comment(issue_id: issue_id, body: "Já reproduzi, investigando.")

client.my_issues.each { |i| puts "#{i['identifier']} [#{i['state']['name']}] #{i['title']}" }

client.viewer
# => {"name"=>"...", "email"=>"..."}

Todos os métodos lançam LinearClient::Client::Error se a API retornar erros GraphQL.

Suíte em RSpec, com WebMock simulando as respostas da API (nenhum teste bate na rede real):

bundle install
bundle exec rspec

# Lista os times e cria um card de teste no time indicado pelo key (ex: ENG)
ruby examples/create_issue.rb ENG

# Lista as issues atribuídas a você
ruby examples/my_issues.rb

# Exporta viewer + issues atribuídas para JSON
ruby examples/report.rb caminho/para/saida.json

• A API key vai no header Authorization (sem prefixo Bearer), conforme exigido pela API do Linear.
• Nunca dê commit em arquivos .env ou qualquer arquivo com a chave em texto puro — este repositório já ignora .env via .gitignore.

MIT