Learning Path

This tutorial site has a lot of content; rather than reading top to bottom, choose a path by your experience level. Each level spells out "what to read, and what you'll achieve".

🟢 New users: first get it running

Goal: set up your key, open a dialog box, and know what's going on.

1. Quickstart: configure your key, open the Web UI, first conversation
2. Command Line: dsh web / --profile headless / --dump-config
3. Configuration: profiles, the patch layer, API keys
4. What is DSH: what exactly it is

✅ Afterwards you can: configure a key, open the Web UI, and view --dump-config.

🟡 Everyday use: make it convenient

Goal: know how much it can do, and how to manage permissions and privacy.

1. Built-in Tools: what the 21 factory tools can do
2. Permissions: presets, ask/never, DSH_PERMISSION_MODE
3. Data and Privacy: telemetry, .anonymous-user-id, session storage
4. Multi-Model Routing: how to configure providers
5. Subagents and Parallelism: handing work out
6. Goals, Jobs and Todos: pushing long-running matters forward
7. Settings and Credentials: runtime configuration and key management
8. Session Search / Attachments: search past sessions, attach images into a session

✅ Afterwards you can: manage permissions, multiple providers, spin up subagents, and use goals to advance long-running tasks.

🔵 Developers: add capabilities to the model

Goal: write your own plugins, tools, services, listen to events, and publish configuration.

1. Plugin Anatomy: what a plugin is, patch-layer semantics
2. First Plugin: hello world
3. Write a Tool: add a tool to the model
4. Write a Service: shared logic
5. Listen to Events: dispatch modes, event catalog
6. Configuration & Publishing: ctx.settings + publishing
7. Skills System / MCP Integration: extend capabilities further
8. Feedback / Spill Storage / E2B Cloud Sandbox: advanced capabilities mounted on demand

✅ Afterwards you can: write plugins, add tools, register commands, connect MCP, and publish configuration.

🟣 Architects: dig into the principles

Goal: understand how DSH assembles all of this.

1. Architecture Overview: the package-grouping map
2. All 11 core-mechanics chapters: boot-config → context → agent-loop → tools-execution → sandbox-security → session → llm-routing → plugin-anatomy → event-system → web-ui → schedule
3. Workflows and Ralph: multi-agent orchestration
4. Agent Presets and Persona: identity and composition
5. Built-in Tools: full picture

✅ Afterwards you can: explain an agent's complete path from startup to running a tool, and pinpoint "which layer to extend at".

---

💡 Tip: all doc links have no numeric prefixes and can be jumped back; use the right-hand directory for quick navigation; the "Principles Course" works well as a reference manual to query, not something to read in one sitting.