Daily use复制锚点链接

English

Summary复制锚点链接

This page shows the commands you use every day and the choices you make about what the model may change. It assumes Delorun is installed and set up (Install and first run). Delorun runs as one background program per profile, the home process, which serves the studio in your browser. A few commands start, open, stop and check it. Each chat works in a workspace, a folder whose files the model may read and change. When something you added stops Delorun from starting, safe mode starts it without your plugins until you fix it.

Contents复制锚点链接

• Start, open and stop
• Check the release and your setup
• Workspaces and what the model may change
• Make Delorun yours
• Safe mode and recovery
• Trash, export and import
• The plugin and headless commands
• Next
• For the technically curious

Start, open and stop复制锚点链接

delorun and delorun start run Delorun in the background, so it keeps running after you close the terminal, unless you answered No to the background question under More settings in setup. delorun setup background asks it again. A background start prints Delorun is running in the background for the profile default (process <pid>) at <address>, then how to see, follow and stop it.

delorun stop stops new turns, prints Waiting for N running chat(s) to end…, and waits up to 30 minutes before it stops anyway. When it is done it prints Delorun stopped for the profile default. delorun stop --now cancels the running chats instead.

Most commands take --profile <name> after their name to act on another profile, such as delorun status --profile work. DELORUN_PROFILE sets it for every command (Your Delorun home).

Check the release and your setup复制锚点链接

• delorun doctor checks your home's permissions, whether Docker answers, the format of your DeepSeek key (without sending it), whether the studio's port is free, on Linux whether bubblewrap can sandbox commands, the last release-log check and the last update check. Each line starts with pass, warn or fail. It exits with 1 when a check fails; it also reports your changes and your CLI profile's plugins.
• delorun verify checks the installed release against its signed manifest and the public release log. It runs two checks, the release signature and the installed files, and lists the others as not run. Its report ends with this is not a full verification of this Delorun.
• delorun logs prints where each log is and the recent records of the running Delorun (Where Delorun keeps its logs).
• delorun --version prints the Delorun version and the DeepSeek Harness version it runs on.

Workspaces and what the model may change复制锚点链接

A workspace is a folder on your computer. Every chat works in one. The workspace's permission preset decides what the commands the model runs may do:

• Workspace Write. The preset every new workspace starts on. Commands run in the sandbox, a fenced area: they may write inside the workspace and the permitted temporary folders. A command that needs more asks you first, and you approve or deny that one command.
• Full access. Commands run outside the sandbox and can write anywhere your user can, without asking.

Commands the model runs in a Workspace Write workspace cannot write under your Delorun home, read its secrets or tokens, or connect to its control sockets, where your system enforces those rules (What Delorun protects).

With setup's default Ask me first, Delorun asks you once for each workspace before it gives it full access. You answer on the computer Delorun runs on: pick Full access in a chat, use Settings → Safety → Permissions, or choose Allow for this chat on an approval card that asks for it (Full access). Other consents ask before the model edits instruction files, adds an MCP server or schedules work (Consents).

Make Delorun yours复制锚点链接

Delorun is built to be reshaped. You can change plugin settings, build agent presets, skills and plugins in Creator mode, link your own plugins, or edit Delorun's own files. Delorun records each change to what it runs, so you can see it and undo it. An update carries your changes to the new release or names, before you confirm, any it cannot carry (Updates).

• Where to customise what compares the ways to change Delorun and what each costs at an update.
• Write a plugin for Delorun goes from a new plugin to one that loads in your studio.
• Changing your harness explains what delorun changes records, protection, and undo.

Every change Delorun makes to your profile is also a version of the profile's history, which delorun recover can restore.

Safe mode and recovery复制锚点链接

When a plugin or a profile change stops Delorun from starting, or makes it misbehave, start it without your own plugins:

delorun recover safe-mode        # the next start leaves out your plugins
delorun start
delorun recover exit-safe-mode   # once it works: the next start loads everything again

Safe mode leaves out every bundle and plugin you added, including plugins installed from a folder, and keeps DeepSeek Harness's own bundles and Delorun's. It changes no file: your plugins and their settings stay in your profile, and each start in safe mode says what it leaves out. You should see that line at the start.

delorun recover with no subcommand shows where your profile stands: whether safe mode is on, the last update, the profile versions you can restore, and the plugins you ejected or kept disabled.

Trash, export and import复制锚点链接

These commands change chat data the studio uses, so stop Delorun first. They refuse while it runs.

The plugin and headless commands复制锚点链接

• delorun plugin --profile <name> … runs DeepSeek Harness's dsh plugin inside your Delorun home, so plugins install as in stock. It applies none of Delorun's protections. delorun plugin check <directory> reads a plugin's package.json, runs none of its files, and says whether this release would accept the plugin's version ranges.
• delorun headless … answers one task and exits, as dsh headless does, with Delorun's sandbox protection and guards.

Next复制锚点链接

• Keep Delorun current: Updates.
• Choose the model: Model providers.
• Understand the protections: What Delorun protects.
• If something went wrong: Troubleshooting.

For the technically curious复制锚点链接

The delorun/docs/contracts/c19-home-process.md defines start, stop, status and their exit codes. The delorun/docs/contracts/c03-update-report.md defines safe mode and delorun recover. The delorun/docs/contracts/c08-archive-and-trash.md defines the trash and archives.