CLI

sophon is the command-line interface — the fastest way to talk to your assistant, manage everything the Dashboard manages, and automate Sophon from scripts, CI, or cron.

Install

The CLI is published on NuGet as a .NET global tool:

dotnet tool install -g sophon-cli

Update or remove it later with:

dotnet tool update -g sophon-cli
dotnet tool uninstall -g sophon-cli

It runs on Windows, macOS, and Linux (requires the .NET 10 runtime). The installed command is sophon.

First run

sophon onboard     # configure an LLM provider and (optionally) your profile
sophon             # open the interactive chat REPL

By default the CLI talks to a local Gateway at http://localhost:8080. Point it elsewhere with --gateway-url or sophon config set gatewayUrl https://....

Two ways to use it

• Interactive chat — run sophon (or sophon chat) for a full REPL with slash commands, @-mentions, image attach, and live streaming.
• One-shot commands — sophon <group> <command> for everything else: sophon models list, sophon channels add, sophon workflows execute <id>, and more.

Full documentation

The CLI has its own section with the complete reference:

• Sophon CLI — overview & install
• Interactive Chat — REPL, key bindings, slash commands
• Command Reference — every command and option
• Configuration & Authentication
• Themes & Appearance
• Scripting & Automation