SurfacesRoom 06 of 13
Your assistant. Full screen. In the terminal.
A purpose-built terminal client on a custom cell compositor. Sophon owns every cell of the screen. Run it in a repository and it works as a coding agent: diffs to approve, changes to review and undo, all without leaving your prompt.
dotnet tool install -g sophon-cli
Frame 6 of 8. An approval card sits above the composer: email.send, risk HIGH, a 42 second countdown, recipient and subject shown, with Approve and Reject keys.
06 / 08 · Approval card: risk, parameters, countdown
Recreation of the full-screen chat
AWatch a flaky test get fixed
A coding agent that asks first.
Since v2.1, running Sophon in a repository gives you a coding agent bound to that folder. It shows each change before it writes it, and you decide how much it may do on its own.
A full-screen Sophon chat bound to workspace my-service, untrusted. A card asks: Trust files in ~/src/my-service? Keys: y trust, n keep untrusted, q don't bind, Esc decide later.
Step 1 of 6: Trust the folder once
01 / 06 · Trust the folder once
Run
sophonin a repository and the chat binds to its root: the nearest folder at or above you that holds.git, never your home directory. The first time, it asks once.Trusting loads AGENTS.md, runs git for status, and allows accept edits and remembered commands. An untrusted session is still bound: its file tools stay inside the root and every change asks.
The coding agent needs the Gateway on the same machine as the CLI, as the same OS user, over a loopback URL. A remote or containerized Gateway still chats, without a workspace.
Coding agent guideBThe coding agent
An agent bound to one folder.
- Bound to your repository
- Run sophon in a repo and the chat is bound to its root. Trust the folder once and the agent reads AGENTS.md, sees your branch and changed files, and its file tools stay inside the root.
- Every edit is a diff you approve
- Edit cards show the diff; shell cards show the exact command. Approve, reject, or reject with a note and the agent tries again. ⇧⇥ switches between ask before edits, accept edits and read-only plan mode. Build files, CI and AGENTS.md always ask.
- Review it, undo it
- /diff shows what the session, the last turn, or git's working tree changed. /rewind puts back what the edit tools wrote, after showing the diff.
- Plans, checklists, sub-agents
- In plan mode the agent proposes a plan card you can run, edit or send back. A ⌃T checklist tracks progress, /subagents shows each child agent live and stops one without ending the turn, and the context line shows context and cost.
CNew in 2.2
Sophon Code: friendlier at the prompt.
- Pickers instead of arguments
- Type
/agent,/resume,/permissions,/mode,/trust,/exportor/effortbare and a list opens. Typed arguments work as before. Ten duplicate commands are gone, and for this release typing one names its replacement. - Effort, not Thinking
/effortsets how hard the model works on this conversation: Auto, Low, Medium, High, Extra high or Max, stored on the Gateway so every device sees it.-esets it from the command line. Each reply shows the level it ran at.- A context line above the input
- The full-screen chat shows the folder, the branch, a * for uncommitted changes and the branch's open pull request, with context use and the session's cost on the right. The composer sits on an inset band; the footer shows the permission mode, the approval policy and the model the last reply ran on.
- Paste an image
- ⌃V, or ⌥V in Windows Terminal, attaches the image on the clipboard behind an [Image #n] placeholder, and a model with vision sees the pixels. The composer also gains word movement and word deletion keys.
- Allow all tools, when the host opts in
- For a trusted workspace, an Admin can let every tool call in the session run without a card, critical ones included, for a set time. It is off unless the Gateway's host turns it on, the dialog asks first with No as the default, and it ends by itself once the session reads untrusted content.
DThe full-screen surface
Built like a real TUI.
- Scrollback that belongs to the app
- Wheel, PgUp, PgDn scroll an app-managed transcript. Scroll up and a '↓ latest' chip marks where live streaming continues; text selection works with ⇧-drag or F2. Resumed sessions seed the last messages behind a 'resumed ·' divider.
- Approvals that can't be missed
- Risky actions surface as bottom-stack attention cards: a risk-colored rail, the exact parameters, single-key Approve/Reject, and a live countdown. Cards arm after a beat and never steal keys mid-typing.
- Dialogs, not detours
- /theme previews the whole frame live before you commit. Bare /resume and /agent open pickers. /plan overlays the full plan, windowed around the running step, and a '◆ plan 2/5' row keeps progress visible while it runs. ? on an empty composer lists the keys.
- Fast because it repaints less
- Repaints only what changed: under 4 KB per frame while streaming, capped at 30 fps, zero idle CPU. Tool output folds at 10 lines so an all-day session stays readable.
- Degrades gracefully
- Full screen needs a 70×18 window; anything less falls back to a pinned input, then a classic prompt, with nothing to configure. Opt out any layer with an env var, and
sophon doctor --reset-terminalun-sticks a stranded terminal. Exiting prints a resume card so no session is ever lost.
EIn-session commands
One keystroke away.
- ⇧⇥ modes
- /permissions
- /diff
- /rewind
- /init
- /trust
- /todos
- /subagents
- /context
- /model
- /effort
- /agent
- /retry
- /plan
- /resume
- /theme
- @ files
- ⌃V image
- ? keys
- sophon -c
- sophon -p
- sophon -e high
FFits your terminal
Ten themes.
sophon-code
Default
#0D1117 · #4493F8 · #F0F6FC · #3FB950
sophon-code-light
Light terminals
#FFFFFF · #0969DA · #1F2328 · #1A7F37
sophon-code-dimmed
Lower contrast
#212830 · #478BE6 · #D1D7E0 · #57AB5A
sophon-code-high-contrast
Brighter text
#010409 · #74B9FF · #FFFFFF · #2BD853
catppuccin-mocha
Community
#1E1E2E · #CBA6F7 · #CDD6F4 · #A6E3A1
dracula
Community
#282A36 · #BD93F9 · #F8F8F2 · #50FA7B
core-dark
Was indigo-core
#121022 · #8B7CF7 · #E8E6F6 · #34D399
core-extra-dark
Was deep-void
#0A0813 · #A599FA · #F4F3FC · #34D399
graphite
Muted neutral
#34343A · #8B7CF7 · #E4E4E9 · #34D399
core-light
Was daylight
#F0F0F7 · #4C3DC4 · #171722 · #10825C
GAnd your scripts
The whole product is a subcommand.
Chat is the front door, but every Dashboard surface ships as a sophon subcommand (sessions, agents, models, approvals, workflows, memory, nodes) with --json for scripting. And sophon -p runs the agent headless in CI, with NDJSON output and exit codes. It never approves a card: you allow edits and commands up front.
Limits
Where the CLI stops.
The coding agent binds your folder only when the Gateway runs on the same machine, as the same OS user, over a loopback URL. A remote or containerized Gateway still chats, without a workspace.
Coding agent limits/rewind doesn't undo shell commands, deletes, moves, or anything an external coding agent changed. Commit as you go: git is still your real undo.
/diff and /rewindThe working directory is a limit, not a sandbox. An approved command can still leave the root and reach anything the Gateway's OS user can.
The shellWhile allow all is on, nothing asks before a shell command, an edit or a desktop action, whichever client sends the turn. Mobile shows no sign of the mode, and an older CLI or Dashboard keeps showing the previous one.
Permission modesThe prompt-injection guard does not read images. Paste only images you would paste as text.
Pasting imagesHeadless runs never approve a card, and never enter allow all. You allow edits and commands up front.
Headless runs