Tutorials
These task-based walkthroughs cover the path from a fresh installation to reliable day-to-day use, then to writing an installable plugin. They assume Node.js 22.19 or later in the 22.x line, or Node.js 24 or newer, a terminal with TTY support, and a DeepSeek API key for live model turns. Writing a plugin also requires pnpm on PATH.
Each walkthrough lives on its own page so a later change can update one path without rewriting the rest.
| Walkthrough | What it covers |
|---|---|
| Complete your first task | Install, /login, Agent / Workflow / Tools / Access, and a first request |
| Give the agent precise context | @ mentions, image paste, and structured prompts |
| Guide an active turn | Queue, Loop, Plan, Todo, and /goal |
| Recover and manage a long session | Resume, rewind, compact, and export |
| Tune the working environment | /model, /login for extra providers, and /settings |
| Extend a project with Skills and MCP | Project Skills and mcp.json; full reference is Skills and MCP |
| Install the example plugin | omdsh plugin add ./examples/hello |
| Write a plugin | Author, install, inspect, and publish a dsh.bundle package |
The plugin compatibility contract is in User plugins.
Quick reference
| Goal | Action |
|---|---|
| Browse commands and shortcuts | /help |
| Search previous prompts | Ctrl+R |
| Scroll the transcript | PgUp / PgDn, or Shift+Up / Shift+Down |
| Open the Agent Hub | ↓ on an empty composer, then Enter, or Alt+A |
| Copy the latest reply, code block, or command | /copy |
| Choose Agent preset | /agent |
| Choose Default or Plan workflow | /workflow |
| Choose Native, Code, or Both tools | /tool-mode |
| Choose session Access | /permission |
| Inspect session statistics | /session |
| Inspect the session event trajectory | /trajectory |
| Inspect available tools | /tools |
| Repeat work after each completed turn | /loop [count|duration] [prompt] |
| Read release notes | /changelog |
| Install the latest release | npm install --global @agi-fans/oh-my-dsh@latest |
| Install a local plugin bundle | omdsh plugin add ./examples/hello |
| Write a plugin | Write a plugin |
The daily update check only reports a newer npm version; it never installs one automatically.