Skip to content
MyDSHMy DSH Field Notes
中文
Independently maintained; not affiliated with DeepSeek. No association with mydsh.dev or other MyDSH sites.

Home/Getting started/CLI and Web UI

dsh versus dsh web: what each surface gives you for the same task

You are unsure when to use the CLI and when the UI, or a task works in one and looks different in the other.

VerifiedVersion and environmentChecked 2026-11-14
Host version
0.1.2-alpha.5
Checked
2026-11-14

Copyable command

dsh --profile headless "count the files in the current directory"

The relationship is simpler than most people assume: dsh web is an alias for dsh --profile web. Same kernel, different surface.

dsh web          # same as dsh --profile web

Where they differ

CLI profiles (headless / tui)web profile
Output shapePrint once and exit (headless), or an in-terminal UI (tui)A browser session you can scroll, paste into, and revisit
Good forOne-shot tasks, scripting, CI, piping into other commandsLong output, back-and-forth, copying large blocks
Intermediate stepsUsually collapsed to the final resultTool calls and state visible as they happen
Record keepingYou redirect it yourselfSessions persist under $DSH_HOME/sessions

The same task from the command line:

dsh --profile headless "count the files in the current directory"

It answers and exits, which makes it scriptable. The same job in the web UI costs you a click but shows how it got there.

Choosing

  • Automating, piping, scheduling → CLI.
  • Reading long results, asking follow-ups, pasting output to someone → web.
  • Asking why it answered that way → web, where the steps are visible.
Do not expect character-identical output. Context is assembled differently, so wording diverges. Compare conclusions and tool-call counts, not phrasing.

What counts as working

Check every line. All of them pass or the job is not done.

  • Both surfaces return the same count
  • The CLI route exits without leaving a process behind
  • The web route shows the tool-call steps

Where it fails

Symptom, cause, what to do — written in the order it actually happens.

SymptomCauseWhat to do
headless complains the profile does not existNo such directory under $DSH_HOME/profilesList ~/.dsh/profiles; web, desktop, headless is the usual set
The same instruction answers differently in the web UIDifferent context assembly, not an errorCompare conclusions and call counts

Sources

Verified means measured here. Compiled means every line carries a source.