Ir para o conteúdo

Neo — Personal Command Assistant

Assistente pessoal de linha de comando, alta produtividade, modular, seguro e pronto para automação

CI & Deploy Coverage Version Python 3.13+ License MIT

O Neo é um assistente pessoal de linha de comando de alta produtividade construído em Python 3.13, utilizando Typer e Rich. Ele centraliza e automatiza operações técnicas de trabalho — integrando-se nativamente com GitHub, Bitbucket Cloud e Shortcut — investigando informações com autonomia e fornecendo interfaces ricas no terminal.

⚡ Recursos Principais

Suporte unificado a GitHub e Bitbucket. Resolução transparente por flag explícita (--provider / -p), auto-detecção via remote do repositório local ou preferência configurada em config.toml.

Armazenamento seguro de credenciais via Keyring do SO (macOS Keychain, Linux Secret Service, Windows Credential Manager) com fallback inteligente para arquivo restrito (0600) e variáveis de ambiente.

Interfaces visuais modernas estilizadas com Rich (tabelas, alertas, painéis) e suporte à flag global --json para integração transparente com jq, pipelines de CI e scripts de automação.

Investigação contextual de tickets e chamados do Shortcut (neo tasks analyze), sugerindo branches, padrões de commit e critérios de aceite automaticamente.

🚀 Instalação Rápida

# Instalar como CLI global com uv ou pip
uv tool install neo-cmd
# ou: pip install neo-cmd

# Executar diretamente de qualquer diretório
neo --help

uv sync
uv run neo --help

🛠️ Exemplo de Uso

# Exibe o quadro A fazer | Fazendo | Feito (configura as colunas no 1º uso)
neo tasks resume

# Listar apenas as stories atribuídas a você
neo tasks list --mine

# Listar repositórios do provedor ativo (GitHub ou Bitbucket)
neo git repo list

# Busca commits auto-detectando o repositório git atual
neo git commits search --query "fix" --limit 5

# Selecionar workspace ativo interativamente
neo git workspace select

🧭 Metodologia Spec-Driven Development

O Neo é concebido sob rigoroso Spec-Driven Development (SDD). Cada recurso, decisão arquitetural e modelo de dados é rastreável ponta a ponta desde as especificações de negócio até a suíte de testes automatizados com cobertura garantida $\ge 80\%$.