starhui-dev/huly-cli

Huly CLI

Use npx -y @starhui/huly-cli@latest para trabalhar com o Huly através de @firfi/huly-mcp.

Para desenvolvimento local dentro deste repositório, huly também é aceitável após pnpm build && pnpm link --global.

Verificações Rápidas

1. Confirme se a CLI está disponível:

   npx -y @starhui/huly-cli@latest --version
   

2. Verifique primeiro a configuração sanitizada a partir das variáveis de ambiente existentes:

   npx -y @starhui/huly-cli@latest context
   

3. Se faltar configuração necessária, pergunte ao usuário se deseja passar um arquivo dotenv explícito com --config <caminho>.
4. Se o projeto for omitido nos comandos de tarefa, defina HULY_DEFAULT_PROJECT ou use --project.

Nunca imprima tokens reais, senhas ou conteúdos completos de .env. npx -y @starhui/huly-cli@latest context é seguro porque retorna configuração sanitizada.

Comandos Comuns

Listar projetos:

npx -y @starhui/huly-cli@latest project list --json

Descobrir status antes de criar ou atualizar tarefas:

npx -y @starhui/huly-cli@latest project statuses HULY --json

Listar tarefas:

npx -y @starhui/huly-cli@latest issue list --project HULY --status-category active --limit 20 --json

Obter uma tarefa:

npx -y @starhui/huly-cli@latest issue get HULY-123 --project HULY --json

Criar uma tarefa:

npx -y @starhui/huly-cli@latest issue create --project HULY --title "Título imperativo curto" --description "Corpo em Markdown"

Atualizar uma tarefa:

npx -y @starhui/huly-cli@latest issue update HULY-123 --project HULY --status Done

Pesquisar:

npx -y @starhui/huly-cli@latest search "texto da consulta" --limit 10 --json

Acesso Bruto a Ferramentas

Use chamadas brutas quando a CLI de primeiro nível não expõe uma ferramenta MCP upstream:

npx -y @starhui/huly-cli@latest tools --filter document
npx -y @starhui/huly-cli@latest call get_issue --field project=HULY --field identifier=HULY-123 --json
npx -y @starhui/huly-cli@latest call list_projects --data '{"limit":10}' --json

--field chave=valor converte true, false, null e números. Use --data ou --file para JSON aninhado.

Segurança

• Use --json para análise por agentes.
• Leia antes de escrever: inspecione o projeto/status/tarefa antes de modificá-lo, a menos que o usuário tenha fornecido valores exatos.
• Comandos destrutivos exigem confirmação; só use --yes quando o usuário solicitar explicitamente a exclusão.
• Prefira nomes de status vindos de project statuses; não invente status de fluxo de trabalho.
• Se um comando falhar devido a autenticação/configuração, reporte os campos sanitizados ausentes de npx -y @starhui/huly-cli@latest context; não exponha segredos. Só tente novamente com --config <caminho> após o usuário confirmar qual arquivo dotenv usar.

Mapeamento Útil

• Projetos: project list, project get, project statuses, project create, project update, project delete.
• Tarefas: issue list, issue get, issue create, issue update, issue delete, issue label, issue unlabel, issue move.
• Pesquisa global: search.
• Todas as ferramentas MCP upstream: tools e call.