A CLI do Sytex (sytex) conecta seu ambiente local à plataforma Sytex. Você pode usá-la diretamente pelo terminal ou conectá-la a agentes de programação com IA, como Codex e Claude Code.
Como você pode usá-la
Pelo terminal: execute comandos para explorar e gerenciar o Sytex.
Com um agente de IA: instale as skills do Sytex para que Codex ou Claude Code possam trabalhar com o Sytex por meio de solicitações em linguagem natural.
As duas opções usam a mesma instalação da CLI e uma conta autenticada no Sytex.
macOS / Linux: nenhum requisito adicional — você só precisa ter curl e tar disponíveis (eles já vêm instalados por padrão na maioria dos sistemas).
Windows: PowerShell 5 ou posterior (incluído por padrão no Windows 10/11).
Instalação no macOS e Linux
Abra um terminal e execute:
curl-fsSL https://cli.sytex.io/install.sh |sh
O instalador detecta sua plataforma, baixa o binário correspondente, verifica o checksum SHA256 e instala o executável em ~/.local/bin/sytex. Ele também instala o preenchimento automático para o shell atual (zsh, bash ou fish).
Instalação no Windows (PowerShell nativo)
Abra o PowerShell e execute:
irm https://cli.sytex.io/install.ps1 |iex
Após a instalação, feche e abra novamente o PowerShell para que ele reconheça o novo PATH. Para usá-lo na sessão atual sem reiniciar:
Na primeira vez que você executar o sytex.exe, o Windows SmartScreen poderá exibir a tela azul "O Windows protegeu o computador", porque o binário não é assinado. Clique em Mais informações → Executar assim mesmo — o Windows memorizará sua escolha e não perguntará novamente.
Adicionando a CLI ao PATH
O instalador coloca o binário em ~/.local/bin/sytex. Se esse caminho não estiver no seu PATH, você verá um aviso ao final da instalação, semelhante a este:
[sytex] WARNING: /home/user/.local/bin is not in your PATH.
[sytex] Add it by appending the following line to your shell profile
[sytex] (e.g. ~/.bashrc, ~/.zshrc, or ~/.profile):
[sytex] export PATH="$HOME/.local/bin:$PATH"
Para corrigir, copie e cole este comando no terminal — ele adiciona a linha ao ~/.bashrc e aplica a alteração à sessão atual:
Se você usa zsh em vez de bash (o padrão no macOS), substitua ~/.bashrc por ~/.zshrc no comando acima.
Entrar
Para se autenticar na plataforma, execute:
sytex login
O comando exibe uma URL de autenticação. Por padrão, ele solicita que você copie e cole essa URL manualmente no navegador.
Para que a CLI abra o navegador automaticamente:
sytex login --browser
Nos dois casos, depois que você se autenticar no navegador, suas credenciais serão armazenadas localmente e os próximos comandos as utilizarão automaticamente.
Conectar o Sytex a um agente de IA
Se você pretende usar a CLI somente pelo terminal, pode pular esta seção.
Para instalar as skills do Sytex em todos os agentes compatíveis detectados no seu computador, execute:
sytex skill install
A CLI detecta os agentes compatíveis por meio dos diretórios de configuração:
Claude Code:~/.claude/
Codex:~/.codex/
Se os dois diretórios existirem, as skills serão instaladas para ambos os agentes. Para escolher um agente específico, use:
sytex skill install--provider claude-code
sytex skill install--provider codex
Isso instala as skills incluídas sytex-assistant e wizard, além das skills publicadas pela sua organização no Sytex.
Reinicie a sessão do agente após a instalação para que ele descubra as novas skills. Depois, você pode verificar a conexão pedindo ao agente que liste as organizações do Sytex às quais você tem acesso.
Verificar a instalação
Confira se a CLI está funcionando:
sytex --version
A versão instalada deverá ser exibida. Se você receber command not found, feche e abra novamente o terminal (ou execute source ~/.bashrc) para que ele reconheça a alteração no PATH.
Atualizar a CLI
Para atualizar para a versão mais recente, basta executar:
sytex update
A CLI baixa a nova versão e substitui o binário automaticamente.
Problemas comuns
O script de instalação não funciona no PowerShell ou no CMD. No Windows, use install.ps1 com irm https://cli.sytex.io/install.ps1 | iex (consulte a seção de instalação acima). O install.sh é exclusivo para shells Unix — macOS e Linux.
sytex: command not found após a instalação. Normalmente, isso indica um problema no PATH. Verifique se você executou o comando da seção "Adicionando a CLI ao PATH" e abriu um novo terminal.