Before uninstalling DeepSeek Harness: export these three
Before uninstalling DeepSeek Harness, export the material you cannot rebuild: session history, the DSH plugin manifest, and configuration. The core installs again in minutes, but conversations, tool traces and long-term settings do not come back by themselves. What follows is what each export contains and where a backup that looks complete still fails.
The three data categories in a DeepSeek Harness backup
A useful backup is defined by what it lets you reconstruct, not by how many files it contains.
| Category | What it holds | What disappears without it |
|---|---|---|
| Session records | conversations, tool calls, errors, timestamps | no way to review past work |
| Plugin manifest | package names, versions, profiles, sources | the environment cannot be reproduced |
| Configuration | models, paths, feature settings, credential references | behavior drifts after reinstall |
Session records answer what happened, the manifest answers what was installed, and configuration answers how the environment behaved. Each category covers a different failure after reinstall, so losing one leaves a gap the others cannot fill. A folder full of files is not a backup until you know which category each file belongs to.
Most people export the obvious directory and stop there. Those files may cover sessions, yet say nothing about which plugin versions were loaded when the sessions ran. That missing context is why a restored setup can open an old conversation and still behave differently.
The categories also have different lifetimes. Sessions accumulate slowly and matter for audit, while configuration changes often and matters for daily work. The manifest sits between them and records the state of a single moment.
Exporting session records from DeepSeek Harness
Session data is the part of a DeepSeek Harness backup that no registry can rebuild.
Copy the data directory while the application is idle, so no session is half-written. Include the logs that share the same time range as the sessions you keep. If your version offers an export command, use it and compare the output against the directory copy.
Search the copy for a phrase you remember from a recent conversation. Open one old session and scroll to a tool call, not just the first message. A session that loads but cannot render its tool output is not a usable export.
Redact anything sensitive before the archive leaves your machine. Internal hostnames and API keys tend to appear inside logs even when the conversation text looks clean. Keep the redacted archive separate from the original for a few days.
Logs from the operating system can help when the application logs stop early. They usually live outside the data directory, so copy them separately. Add their location to the index rather than guessing later.
Capturing the DSH plugin manifest
A screenshot of an installed plugin list is not a manifest, because it cannot be searched, diffed or replayed.
Run the plugin listing command and redirect its output to a text file. Record the version next to each entry, along with the profile that loads it. Note where each package came from, since a marketplace install and a local tarball install need different steps later.
Disabled plugins belong in the list as well, marked as disabled. They are part of the environment you configured, and reinstalling without them changes the shape of the setup. Check the list through the DSH Plugin Hub entry when you need canonical package names.
- Dump the installed plugin list to a text file.
- Add versions, sources and profile names.
- Mark entries that are installed but disabled.
- Save the DeepSeek Harness core and runtime versions alongside.
- Re-read the file and confirm each line maps to an install command.
Read the finished file as if you were the person restoring it next month. If any line requires memory you will not have, rewrite it. A manifest that needs its author is not documentation.
Saving DeepSeek Harness configuration without leaking keys
Configuration should travel as references and redacted values, never as a plaintext secret store.
Export model settings, file paths and plugin options exactly as they are used. Replace every secret with the name of the credential that supplies it. The goal is a file that explains how the environment was wired without granting access to it.
Store the actual keys in a password manager or an encrypted archive that lives somewhere else. A backup that bundles keys next to configuration turns a routine uninstall into a disclosure event. If you must keep a copy, encrypt it and note the passphrase location in your runbook.
Configuration formats change between releases, so add the core version to the header of the file. A reader in six months needs to know which schema the values belong to. That one line prevents hours of misreading defaults as deliberate choices.
Review the redacted file once with a search for common key prefixes and internal hostnames. Redaction by hand misses things that a simple pattern match finds. The review takes a minute and is worth doing before the archive is sealed.
The index that makes a DeepSeek Harness backup complete
What usually goes missing is the index: the short file that says what each artifact is and how the pieces fit together.
A folder of exports can look thorough and still be unusable, because nothing explains which manifest belongs to which profile. The index is a plain text inventory with one line per artifact, including its date and version. It is the difference between a pile and a backup.
Write the index last, after every export is in place, and list what you actually produced rather than what you planned. Include the machine, the operating system, the core version and the date. If an expected artifact is absent, write that down too, so the gap is visible during the restore drill.
The index can be a single checksum file or a short markdown page. Keep it inside the archive at a predictable path such as the root level. Future you will open the archive, see the index first and know where to start.
If the index and the artifacts ever disagree, trust the artifacts and correct the index. The mismatch is itself useful information about how the export was assembled. Fix it before the archive is moved, not after.
Testing a DeepSeek Harness restore before uninstalling
An export that has never been restored is a hypothesis, and uninstalling is a bad time to test it.
Restore the configuration and the manifest in a scratch environment before you remove anything. Install the listed DSH plugins and compare the resulting list with the manifest line by line. Open an old session and run one small task that exercises a DeepSeek Harness plugin you rely on.
If something fails, fix the export now, while the original still exists. Record the drill date in the index, because a backup without a test date invites false confidence. Then, and only then, proceed with the uninstall.
The uninstall itself takes a minute, while the exports decide what you keep. Three categories, one index and one successful drill are enough to make the removal reversible. Everything else is packaging detail.
A drill is also a rehearsal for the reinstall steps themselves. You learn where the manifest lives, which command restores configuration and how long it takes. That knowledge is the real product of the exercise.
FAQ
Before uninstalling DeepSeek Harness, back up sessions and logs, the DSH plugin manifest with versions, and configuration with credential references. Missing one leaves a gap after reinstall.
DSH plugin versions should be exported from the command line rather than screenshots. Screenshots cannot be searched or used for reinstall.
When backing up DeepSeek Harness configuration that contains keys, redact or encrypt it. A plaintext backup turns an uninstall into a leak.
Confirm a DeepSeek Harness backup by restoring configuration, then the plugin manifest, then opening an old session. All three readable means the backup works.
Backing up sessions without the DSH plugin manifest leaves you unable to reproduce the plugin set after reinstall. Sessions open, but tools and behavior may differ.
Related Terms
- export manifest (backup list)
- An export manifest is the pre-uninstall list of sessions, plugins, configuration and versions. It gives the reinstall a checklist.— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
- session archive (history copy)
- A session archive is a copy of sessions and logs kept for review after uninstall. It complements the plugin manifest.— https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
- credential reference (config pointer)
- A credential reference points to a secret rather than storing it. Back up the reference relationship and keep keys separately redacted.— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
- restore drill (restore rehearsal)
- A restore drill restores the backup in another environment before uninstalling. It finds missing pieces before deletion, not after.— https://www.npmjs.com/package/@deepseek-ai/dsh
Sources
- deepseek-harness CLI README· GitHub
- DeepSeek Harness docs — quickstart· deepseek-harness.github.io
- npm — @deepseek-ai/dsh· npm