README
oh-my-dsh
Into the Unknown
oh-my-dsh is a terminal coding agent built on DeepSeek Harness. Launched as omdsh, it focuses on clear visual hierarchy, smooth keyboard-and-mouse controls, and reliable long-session workflows.
Documentation · English · 简体中文
https://github.com/user-attachments/assets/bedf83db-df50-43e4-a786-61ad42cf5a7d
A 72-second walkthrough (captured with v0.29.2) showcases omdsh across DeepSeek Harness agent presets (Standard, PTC, Minimal, Creator), live /model, /settings (all six sections with instant Catppuccin Dark and Light switching), /plugins bundles, /mcp servers, daily terminal craft (!shell, @ mentions, /btw, /diff, clickable #L file previews), and autonomy workflows (/permission Auto review, /team, /trajectory, session branches, and Alt+R file recovery).
Quick start
Requirements: Node.js 22.19+ (22.x) or Node.js 24+, plus a DeepSeek account or API key.
npm install --global @agi-fans/oh-my-dsh
omdsh
Inside omdsh, run /login to sign in with a DeepSeek account or save an API key, then run /model to pick your model (account users choose a model under deepseek-account). You can also try npx @agi-fans/oh-my-dsh without a global install. Follow the quick-start tutorial to complete your first code edit and diff review in a few minutes.
Highlights
- Clear process, easy diff review. Thinking and tool calls start compact and fold into a duration summary when finished, keeping answers and errors visible. Review edits side by side in
/diff, quote lines straight back into your prompt, or pressCtrl+Oanytime to inspect full tool details. - Careful terminal typography. Markdown, code blocks, tables, and diffs have deliberate spacing and Catppuccin Dark, Light, or System palettes. Borders stay aligned with CJK text and emoji while preserving native terminal scrollback.
- Fast context and side queries. Reference files or past sessions with
@, paste screenshots, run persistent shell commands directly from the input box with!command, or ask quick side questions with/btwwithout cluttering the main thread. - Stay in control of complex and multi-agent work. Review plans with
/planbefore editing, queue, steer, or interrupt active turns, track long tasks with/goal,/jobs, and/schedule, and coordinate subagents, Codex/Claude Code integrations, or/teamAgent Teams. - Branchable sessions and safe file recovery. Search and resume earlier sessions, press
Esctwice to explore conversation branches, restore file snapshots withAlt+Rwhen an edit goes wrong, and check/context,/trajectory, and the live status footer anytime. - Extend without friction. Capture team workflows in project
SKILL.mdfiles, add and probe MCP servers live in/mcpwithout restarting, connect local language servers (LSP) for accurate code navigation, and manage plugins or built-in integrations in/plugins.
Find your way through the docs
New to omdsh? Start with the tutorial guide in order, or jump straight to what you need:
| You want to | Start here |
|---|---|
| Install, sign in, and complete your first code change | Complete your first change, Tune your terminal and models |
| Level up your everyday coding workflow | Give precise context, Steer long tasks, Subagents and Agent Teams, Manage long sessions |
| Add Skills, MCP, LSP, or plugins | Skills and MCP tutorial, Install plugins and integrations, Language servers |
| Look up a command, shortcut, setting, or fix an issue | Commands, Keyboard and mouse, Settings, Status and diagnostics, Troubleshooting |
| Build a plugin or understand internals | Write and publish a plugin, Plugin internals, Architecture |
The bilingual Markdown under apps/site/content/ is the documentation source of truth. To report a bug or suggest an improvement, use the issue forms.
Everyday configuration
Most configuration happens right inside the terminal—no manual config editing required:
更多「命令列與終端機」外掛
deepseek-harness-docker
作者 runzhliu
社群 Docker 與 Kubernetes 打包,含加固映象、Compose、Helm、Web UI 與無頭 CLI。
deepseek-harness-android
作者 dphmoblie
dsh安卓版:整合 DeepSeek Harness、Ubuntu 執行環境、外掛與檔案管理,以及使用者授權的 Shizuku 和無障礙自動化。
dsh-subagent-codex
作者 mjylfz
讓 DeepSeek Harness 以 Codex CLI 作為子代理的外掛,在對話中複用 Codex 的編碼與推理能力。
mnemon
作者 mnemon-dev
LLM 監督的持久記憶系統,基於圖結構召回、跨會話知識共享,單個二進位制檔案,相容 DeepSeek Harness 等執行時。
