starhui-dev/huly-cli

Huly CLI

Usa npx -y @starhui/huly-cli@latest para trabajar con Huly a través de @firfi/huly-mcp.

Para desarrollo local dentro de este repositorio, huly también es aceptable después de pnpm build && pnpm link --global.

Verificaciones Rápidas

1. Confirma que el CLI esté disponible:

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

2. Revisa la configuración saneada a partir de las variables de entorno existentes primero:

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

3. Si falta configuración requerida, pregunta al usuario si debe pasar un archivo dotenv explícito con --config <ruta>.
4. Si se omite el proyecto en comandos de tareas, establece HULY_DEFAULT_PROJECT o pasa --project.

Nunca imprimas tokens reales, contraseñas o contenidos completos de .env. npx -y @starhui/huly-cli@latest context es seguro porque devuelve configuración saneada.

Comandos Comunes

Listar proyectos:

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

Descubrir estados antes de crear o actualizar tareas:

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

Listar tareas:

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

Obtener una tarea:

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

Crear una tarea:

npx -y @starhui/huly-cli@latest issue create --project HULY --title "Título imperativo corto" --description "Cuerpo en Markdown"

Actualizar una tarea:

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

Buscar:

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

Acceso Sin Procesar a Herramientas

Usa llamadas sin procesar cuando el CLI de primera clase no exponga una herramienta MCP ascendente:

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 clave=valor convierte true, false, null y números. Usa --data o --file para JSON anidado.

Seguridad

• Usa --json para el análisis del agente.
• Lee antes de escribir: inspecciona el proyecto/estado/tarea antes de modificarlo a menos que el usuario haya dado valores exactos.
• Los comandos destructivos requieren confirmación; solo pasa --yes cuando el usuario haya solicitado explícitamente la eliminación.
• Prefiere nombres de estado de project statuses; no inventes estados de flujo de trabajo.
• Si un comando falla por autenticación/configuración, reporta los campos saneados faltantes de npx -y @starhui/huly-cli@latest context; no expongas secretos. Solo reintenta con --config <ruta> después de que el usuario confirme qué archivo dotenv usar.

Mapeo Útil

• Proyectos: project list, project get, project statuses, project create, project update, project delete.
• Tareas: issue list, issue get, issue create, issue update, issue delete, issue label, issue unlabel, issue move.
• Búsqueda global: search.
• Todas las herramientas MCP ascendentes: tools y call.