dsh-evolve-in-git

<a href="./README.md">English</a> · <a href="./README.zh-CN.md">中文</a>

Git-backed long-term memory and evolution plugin for DeepSeek Harness.

Contents

• What it does
• Install
• Usage
• Architecture
• Data layout
• Config
• Harness entry points
• Browser half
• Development
• Delivery notes
• License

What it does

This plugin treats a user-chosen or preconfigured Git repository as the memory store. It can write session notes, branch-specific records, and reusable skill drafts into that repo, then commit them as ordinary Git history.

Install

# example: install into the web profile
 dsh plugin --profile web add github:Kytolly/dsh-evolve-in-git

The bundle inserts one dsh-evolve-in-git row with the plugin defaults. Later profile patches can override repoPath, repoUrl, auth, and the storage roots.

Usage

Natural language

You do not need to remember tool names — describe the outcome and the model selects the right evolve_* / memory_* tool:

You say (or similar)	The model uses
"Remember: whenever X happens, do Y"	evolve_remember / memory_save
"Any memory about the deploy flow?"	evolve_recall / memory_search
"Read my recent memory history"	evolve_timeline
"Turn this warning into a reusable skill"	evolve_skill_draft → evolve_skill_promote
"What is the memory repo's current state?"	evolve_status / evolve_branches
"Undo the last memory commit"	evolve_rollback

Commands (/evolve)

For explicit, deterministic control, type /evolve <subcommand>:

/evolve remember warning "pitfall" :: <content>
/evolve search deploy
/evolve skill list
/evolve skill promote evolve-process
/evolve status
/evolve help

The full command reference is under Harness entry points.

Architecture

The package is split into a framework-free core and a thin DSH adapter:

• src/core.ts (GitMemoryCore) is the portability boundary. It depends only on Node built-ins and sibling core modules — never on @deepseek-ai/* — and resolves config from the on-disk file over the host-provided base.
• src/index.ts (GitEvolutionService) is the adapter: it registers Cordis tools, the /evolve command, the system-prompt section, the skill provider, and the config-file route, then maps every surface onto GitMemoryCore.

…