sophon-cli
1.7.0
See the version list below for details.
dotnet tool install --global sophon-cli --version 1.7.0
dotnet new tool-manifest
dotnet tool install --local sophon-cli --version 1.7.0
#tool dotnet:?package=sophon-cli&version=1.7.0
nuke :add-package sophon-cli --version 1.7.0
sophon — the Sophon command-line interface
Sophon is an enterprise-grade AI personal assistant — "an intelligent operating system for your digital life." This package is its cross-platform CLI, distributed as a .NET global tool.
Install
dotnet tool install -g sophon-cli
To upgrade:
dotnet tool update -g sophon-cli
Requires the .NET 10 SDK on your machine.
Quick start
# First-run setup wizard (guides you through your first model provider + channel)
sophon onboard
# Start the local Sophon Gateway (or point at a remote one)
sophon start
# Open the interactive chat REPL — streaming tokens, inline approvals, tool progress
sophon
If you run sophon with no arguments, you drop straight into a terminal chat that feels like Claude Code or GitHub CLI: token-by-token streaming, plan trees that update in place, tool-progress lines, inline approval cards, and Ctrl+C to cancel (once to cancel the task, twice to exit).
What you can do from the CLI
Every surface the Sophon Dashboard exposes is available as a sophon subcommand.
| Area | Command |
|---|---|
| Chat | sophon (REPL), sophon chat |
| Sessions | sophon sessions list\|get\|rename\|archive\|delete |
| Agents | sophon agents list\|get\|create\|soul |
| Models & providers | sophon models list\|add\|test\|remove, sophon models github-copilot login |
| Approvals (HITL) | sophon approvals pending\|decide\|edit\|history\|watch |
| Tasks / runs / plans | sophon tasks active\|recent\|cancel\|watch, sophon runs active\|get\|cancel\|wait, sophon plans cancel |
| Channels | sophon channels list\|add\|test\|enable\|disable\|remove |
| Connections (OAuth + keys) | sophon connect list\|connect\|test\|revoke |
| Skills & marketplace | sophon skills list\|install\|uninstall\|generate\|marketplace |
| Workflows | sophon workflows list\|create\|execute\|versions\|rollback\|test-node\|check-credentials |
| Cron | sophon cron list\|add\|pause\|resume\|trigger\|history\|delete |
| Documents & memory | sophon docs upload\|ask\|summarize\|search, sophon memory list\|add\|search\|daily-logs |
| Voice | sophon voice providers list\|add, sophon voice transcribe, sophon voice runtime start\|stop |
| Nodes (remote desktop) | sophon nodes pair\|approve\|permissions\|command\|wait |
| MCP | sophon mcp list\|add\|reconnect\|tools\|bundles |
| Webhooks | sophon webhooks list\|create\|toggle\|history\|test |
| Insights & home | sophon insights show, sophon home |
| Push notifications | sophon push register\|preferences\|test |
| Canvas / ClaudeCode / PTY | sophon canvas follow, sophon claude-code stream, sophon pty open |
| Ops (admin) | sophon ops status\|logs\|doctor\|action |
| CLI config | sophon config get\|set\|list\|path\|validate\|reset |
Run sophon --help for the full tree, or sophon <command> --help for any subcommand.
Inside the chat REPL
The chat REPL accepts normal messages and slash commands:
sophon (default) > /plan # show the current execution plan
sophon (default) > /tasks # list active background tasks
sophon (default) > /approvals # list pending approval gates
sophon (default) > /cancel # cancel the running task or plan
sophon (default) > /attach ./a.pdf # upload + send a file in your next message
sophon (default) > /save 1 # download the Nth attachment from the last batch
sophon (default) > /new # start a fresh session
sophon (default) > /resume <id> # resume an existing session
sophon (default) > /help # full slash-command list
Press Ctrl+C once to cancel the currently running task or plan without leaving the REPL; press it again within two seconds to exit.
Configuration
The CLI stores its own settings at ~/.sophon/config/cli.json. Inspect or change them with:
sophon config list
sophon config set gatewayUrl https://sophon.example.com
sophon config path
Environment overrides (take precedence over the config file):
| Variable | Purpose |
|---|---|
SOPHON_GATEWAY_URL |
Gateway base URL |
SOPHON_AUTH_TOKEN |
Bearer token used by the CLI |
SOPHON_FORMAT |
Default output format (table, json, yaml, csv) |
The CLI and the Sophon Gateway/Dashboard share ~/.sophon/ as a user-owned data directory — see the Sophon data directory reference.
Links
- Product: https://sophon.buildersoft.io
- Documentation: https://sophon.buildersoft.io/docs
- Terms / EULA: https://sophon.buildersoft.io/terms
- Issues: https://github.com/buildersoftio/sophon/issues
License
Proprietary — Copyright (c) Buildersoft LLC. Use of this software is governed by the Sophon EULA. See LICENSE.txt.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.