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 等运行时。
