Ir para o conteúdo

Configuração & Credenciais

O Neo nunca salva tokens em texto aberto sem proteção. Você pode usar o Keyring do sistema operacional no seu computador pessoal e variáveis de ambiente em pipelines de CI/CD sem mudar uma linha nos seus scripts.

Ordem de Precedência de Credenciais

Sempre que um comando chama a API do GitHub, Bitbucket Cloud ou Shortcut, o Neo resolve o token nesta ordem:

graph TD
    A["Chamada de API"] --> B{"1. Variável de Ambiente?"}
    B -- "Sim" --> C["Usa token da variável de ambiente"]
    B -- "Não" --> D{"2. Keyring do SO?"}
    D -- "Sim" --> E["Recupera segredo do Keyring"]
    D -- "Não" --> F{"3. Arquivo ~/.config/neo/credentials.toml?"}
    F -- "Sim" --> G["Recupera segredo do arquivo 0600"]
    F -- "Não" --> H["Erro: credencial não configurada"]
  1. Variáveis de Ambiente (ideal para CI/CD e containers):
  2. GITHUB_TOKEN
  3. BITBUCKET_TOKEN
  4. SHORTCUT_TOKEN
  5. Keyring Nativo do Sistema Operacional (padrão no desktop):
  6. macOS: Keychain Access
  7. Linux: Secret Service API / Freedesktop
  8. Windows: Windows Credential Manager
  9. Fallback Local Restrito:
  10. Caminho: ~/.config/neo/credentials.toml
  11. Permissão forçada: 0600 (leitura e escrita restritas ao seu usuário).

Comandos de Configuração

Cada domínio gerencia suas credenciais: neo git config para provedores Git e neo tasks config para gestão de tarefas. O comando raiz neo config show exibe o diagnóstico consolidado.

Ver Diagnóstico Geral (neo config show)

# Exibe provedor padrão, workspaces ativos e status de cada token
neo config show

# Versão em JSON para healthcheck em scripts
neo --json config show

Credenciais Git (neo git config auth)

# Solicita o token sem exibi-lo na tela nem gravar no history do shell
neo git config auth set github
neo git config auth set bitbucket

neo git config auth set github --token "ghp_meu_token"

neo git config auth get github

neo git config auth delete bitbucket

Provedor Git Padrão (neo git config)

Quando você executa neo git repo list fora de um repositório Git e sem passar --provider / -p, o Neo usa o provedor padrão salvo em ~/.config/neo/config.toml:

# Definir GitHub como padrão global
neo git config set-provider github

# Definir Bitbucket como padrão global
neo git config set-provider bitbucket

# Consultar qual provedor está ativo como padrão
neo git config get-provider

Credenciais e Colunas de Tasks (neo tasks config)

neo tasks config set

neo tasks config set --service shortcut --token "seu_token"

neo tasks config get
neo tasks config delete

# Assistente interativo: busca os estados reais do seu workflow na API
neo tasks config columns

# Ou defina diretamente por flag (aceita múltiplas colunas separadas por vírgula)
neo tasks config columns \
  --todo "📝 - Backlog de Sprint, 🚨 - Bug" \
  --doing "🚧 - Em Progresso" \
  --done "✅ - Finalizado"

Como Funciona o Mapeamento do Quadro (neo tasks resume)

O comando neo tasks resume agrupa suas tarefas em três colunas no terminal: A fazer, Fazendo e Feito. Como cada time usa nomes diferentes de etapa no Shortcut, o Neo salva a correspondência em ~/.config/neo/config.toml:

[shortcut]
todo_columns = ["📝 - Backlog de Sprint", "🚨 - Bug"]
doing_columns = ["🚧 - Em Progresso"]
done_columns = ["✅ - Finalizado"]

Se você rodar neo tasks resume pela primeira vez sem ter configurado as colunas, o próprio comando consulta os estados do seu workflow na API e abre o seletor interativo antes de desenhar o quadro.

Comandos legados removidos

Os caminhos antigos da versão inicial (neo config auth, neo repo, neo workspace, neo commits e neo story) foram substituídos por neo git ... e neo tasks ....