@veska/cli

CLI do Veska AI. Instala skills do catálogo curado direto no seu IDE e roda skills via runner. Faz parte da distribuição: você compra a ferramenta e a distribuição, não as skills.

Uso

npx veska <comando>

Por padrão o CLI fala com http://localhost:3001/api. Sobrescreva com a env VESKA_API_URL:

export VESKA_API_URL="https://api.veska.ai/api"

Comandos

| Comando | Descrição | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | veska login | Autentica (email + senha) e salva o token em ~/.veska/config.json (dir 700, arquivo 600). | | veska logout | Remove o token salvo. | | veska whoami | Mostra o usuário autenticado. | | veska balance | Mostra o saldo de créditos. | | veska search [query] | Lista skills do catálogo. Flags: --category, --take. | | veska install <slug> | Compila a skill para o IDE alvo e registra a instalação. Flag: --target claude-code\|cursor\|codex (default claude-code). | | veska list | Lista skills instaladas. | | veska run <slug> | Executa a skill via runner. Flags: --model, --input (ou stdin), --max-output-tokens. |

Exemplos

# Login
veska login --email [email protected]

# Buscar skills
veska search "code review" --category engineering

# Instalar para Claude Code (default) — escreve em .claude/skills/<slug>/SKILL.md
veska install skill-creator

# Instalar para Cursor — escreve em .cursor/rules/<slug>.mdc
veska install skill-creator --target cursor

# Rodar uma skill
veska run skill-creator --input "crie uma skill de PRs"
echo "texto longo" | veska run resumidor

# Saldo e sessão
veska balance
veska whoami

Compilação canônica → IDE

O install busca a versão latest da skill, valida o frontmatter contra o schema canônico (@veska/shared) e compila para o formato do IDE alvo, respeitando mode (write/append) e path declarados em targets:

• claude-code → SKILL.md com frontmatter name/description (default .claude/skills/<slug>/SKILL.md).
• cursor → .mdc com frontmatter description/alwaysApply (default .cursor/rules/<slug>.mdc).
• codex → markdown com título + corpo (default .codex/skills/<slug>.md).

Se a skill não declarar target para o IDE pedido, o comando falha com mensagem clara listando os targets disponíveis.