The Sytex CLI (sytex) connects your local environment to the Sytex platform. You can use it directly from a terminal or connect it to AI coding agents such as Codex and Claude Code.
How you can use it
From your terminal: run commands to explore and manage Sytex.
With an AI agent: install the Sytex skills so Codex or Claude Code can work with Sytex through natural-language requests.
Both options use the same CLI installation and authenticated Sytex account.
macOS / Linux: no extra requirements — you just need curl and tar available (they come by default on most systems).
Windows: PowerShell 5 or later (included by default on Windows 10/11).
Installing on macOS and Linux
Open a terminal and run:
curl-fsSL https://cli.sytex.io/install.sh |sh
The installer detects your platform, downloads the matching binary, verifies the SHA256 checksum, and installs the executable to ~/.local/bin/sytex. It also installs completions for your current shell (zsh, bash, or fish).
Installing on Windows (PowerShell, native)
Open PowerShell and run:
irm https://cli.sytex.io/install.ps1 |iex
After installing, close and reopen PowerShell so it picks up the new PATH. To use it in the current session without restarting:
The first time you run sytex.exe, Windows SmartScreen may show the blue "Windows protected your PC" banner because the binary isn't signed. Click More info → Run anyway — Windows remembers your choice and won't ask again.
Adding the CLI to your PATH
The installer places the binary at ~/.local/bin/sytex. If that path isn't in your PATH, you'll see a warning at the end of the install, similar to this:
[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"
To fix it, copy and paste this command into your terminal — it appends the line to ~/.bashrc and applies it to the current session:
If you use zsh instead of bash (the default on macOS), replace ~/.bashrc with ~/.zshrc in the command above.
Log in
To authenticate against the platform, run:
sytex login
The command prints an authentication URL. By default, it asks you to copy and paste it into your browser manually.
To have the CLI open the browser automatically:
sytex login --browser
Either way, once you authenticate in the browser your credentials are stored locally, and the following commands use them automatically.
Connect Sytex to an AI agent
If you only want to use the CLI directly from your terminal, you can skip this section.
To install the Sytex skills for every supported agent detected on your computer, run:
sytex skill install
The CLI detects supported agents through their configuration directories:
Claude Code:~/.claude/
Codex:~/.codex/
If both directories exist, the skills are installed for both agents. To target a specific agent, use:
sytex skill install--provider claude-code
sytex skill install--provider codex
This installs the bundled sytex-assistant and wizard skills, plus any skills published by your Sytex organization.
Restart your agent session after installing so it can discover the new skills. You can then verify the connection by asking the agent to list the Sytex organizations you can access.
Verify the installation
Check that the CLI works:
sytex --version
It should print the installed version. If you get command not found, close and reopen your terminal (or run source ~/.bashrc) so it picks up the PATH change.
Update the CLI
To update to the latest version, just run:
sytex update
The CLI downloads the new version and replaces the binary on its own.
Common issues
The install.sh script doesn't work in PowerShell or CMD. On Windows, use install.ps1 with irm https://cli.sytex.io/install.ps1 | iex (see the install section above). install.sh is for Unix shells only — macOS and Linux.
sytex: command not found after installing. This is usually a PATH issue. Make sure you ran the command from the "Adding the CLI to your PATH" section and opened a new terminal.