CLI Reference
The syntic CLI is the primary entry point for agentic coding in the terminal. Every flag, every command, every environment variable is documented here.
Synopsis
syntic [command] [flags]Running syntic with no command starts an interactive REPL session in the current directory.
Commands
syntic (interactive)
Launches a REPL session. The agent reads the current directory, accepts plain-English tasks, and works with your approval.
| Flag | Description |
|---|---|
--model <id> | Override default model for the session |
--plan | Start in Plan Mode — propose before executing |
--no-permissions | Skip permission prompts (use with caution) |
--dangerously-skip-sandbox | Disable sandboxing for this session |
--print | Print final response to stdout and exit (non-interactive) |
--resume <session-id> | Resume a previous session |
syntic login
Authenticates the CLI against syntic.ai. Opens a browser tab for device approval.
syntic logout
Clears the locally stored auth token.
syntic doctor
Runs diagnostics — PATH, auth, network, model access — and prints findings.
syntic update
Updates the CLI to the latest release. Use --rollback to revert to the prior version.
syntic config
Reads, sets, or lists settings.
syntic config get model.default
syntic config set model.default kimi-k2-6
syntic config listSee Settings for the full schema.
syntic skills
Manage installed skills.
syntic skills list
syntic skills install <name>
syntic skills remove <name>
syntic skills create <name>See Skills for authoring details.
syntic mcp
Manage MCP server connections.
syntic mcp add <name> --transport stdio --command "node server.js"
syntic mcp list
syntic mcp remove <name>See MCP Servers.
syntic agents
Manage sub-agent definitions.
syntic agents list
syntic agents create <name>See Sub-Agents.
Environment Variables
| Variable | Purpose |
|---|---|
SYNTIC_API_KEY | Override stored credentials |
SYNTIC_MODEL | Default model for this shell |
SYNTIC_HOME | Override ~/.syntic location |
SYNTIC_NO_TELEMETRY | Disable anonymous telemetry |
SYNTIC_LOG_LEVEL | trace, debug, info, warn, error |
HTTP_PROXY / HTTPS_PROXY | Standard proxy support |
Exit Codes
| Code | Meaning |
|---|---|
0 | Success |
1 | Generic error |
2 | Invalid usage / bad flags |
3 | Auth failure |
4 | Network / API error |
130 | Interrupted (Ctrl+C) |
Shell Integration
# bash / zsh
eval "$(syntic completions zsh)"Enables tab completion for commands, flags, and skill names.