sophon-cli 1.5.0

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global sophon-cli --version 1.5.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local sophon-cli --version 1.5.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=sophon-cli&version=1.5.0
                    
nuke :add-package sophon-cli --version 1.5.0
                    

sophon — the Sophon command-line interface

NuGet

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.

License

Proprietary — Copyright (c) Buildersoft LLC. Use of this software is governed by the Sophon EULA. See LICENSE.txt.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.8.0 86 5/14/2026
1.7.0 75 5/14/2026
1.6.0 94 5/10/2026
1.5.0 96 5/10/2026
1.4.0 98 5/10/2026
1.3.0 100 4/25/2026
1.2.0 95 4/21/2026
1.1.0 92 4/17/2026
1.0.0 100 4/17/2026