Sophon Docs
API Reference

CLI Reference

Quick reference for the Sophon command-line interface.

The sophon CLI is documented in full under Command Line. This page is a quick cheat sheet.

Install

dotnet tool install -g sophon-cli

Common commands

sophon onboard            # first-run setup (provider + profile)
sophon                    # interactive chat REPL
sophon doctor             # diagnose configuration issues
sophon status             # quick system snapshot

# Models & providers
sophon models list
sophon models add         # interactive
sophon models test <id>
sophon models remove <id>

# Channels & connections
sophon channels list
sophon channels add
sophon channels test <id>
sophon connect list
sophon connect test <id>

# Skills, workflows & automation
sophon skills list
sophon skills install <id>
sophon workflows list
sophon workflows execute <id>
sophon cron list
sophon cron add --name <name> --cron "<expr>" --message "<text>"

# Memory & documents
sophon memory search "<query>"
sophon docs upload <file>
sophon docs ask <id> "<question>"

# Sessions, tasks & approvals
sophon sessions list
sophon tasks active
sophon approvals pending
sophon approvals decide <id> --approve

# Config & auth
sophon config list
sophon config set <key> <value>
sophon login
sophon whoami

Global options

OptionDescription
--gateway-url, -gGateway URL (default http://localhost:8080)
--format, -fOutput format: table, json, csv
--jsonShorthand for --format json
--no-colorDisable colored output (honors NO_COLOR)
--verbose, -vVerbose output
--versionShow version

See the full Command Reference for every command and option, and Scripting & Automation for CI/JSON usage.