sophon-cli 1.9.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).

Modern chat experience (Sophon CLI v2)

Opt-in while the LineEditor feature gap with the legacy InputHandler closes. Enable with SOPHON_CLI_V2=1 or by setting "v2": true in ~/.sophon/config/cli.json. See docs/CLI.md → Roadmap / Known gaps for what's not yet wired.

Key bindings in chat REPL

Discovery

• Type / at column 0 → slash menu opens with fuzzy filter
• Type @ anywhere → mention popover (@file, @agent:name, @session:id) — shows initial candidates; does not refilter as you keep typing past @
• Multi-line paste auto-detected via bracketed paste

Themes

SOPHON_THEME=indigo-core|deep-void|graphite|daylight overrides the auto-detected theme. NO_COLOR=1 strips all color.

Opt-in / opt-out

V2 is off by default. To enable: SOPHON_CLI_V2=1 sophon (env wins) or "v2": true in cli.json. To force off: SOPHON_CLI_V2=0 sophon.

For the full reference (slash commands, scripting, embedded-terminal degradation, troubleshooting, roadmap), see docs/CLI.md.

What you can do from the CLI

Every surface the Sophon Dashboard exposes is available as a sophon subcommand.

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):

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.