DSH | dsh-project-brain | Persistent project memory and architecture intelligence

[yj-liuzepeng]

Unofficial community plugin — not maintained or endorsed by the DeepSeek Harness team.

dsh-project-brain

dsh-project-brain is a persistent project intelligence and memory plugin for DSH. It helps developers understand an unfamiliar repository, retain architectural decisions and change history across Sessions, and recover useful context when switching conversations.

• Repository: https://github.com/yj-liuzepeng/dsh-project-brain
• Public beta release: https://github.com/yj-liuzepeng/dsh-project-brain/releases/tag/v0.7.0-beta.1
• License: MIT
• Languages: English README + Chinese README

What it does

• Scans the current runtime workspace, recognizing languages, frameworks, entry points, and important files.
• Produces a semantic architecture report: project purpose, architecture style, layers, responsibilities, relationships, and risks. It uses the current DSH LLM route when available and falls back to deterministic local analysis.
• Persists decisions, lessons, constraints, changes, TODOs, and Session summaries under the project itself, isolated by workspace.
• Injects a compact context summary into later Sessions, so a new conversation can continue with accumulated project knowledge.
• Uses zero-configuration local BM25 retrieval by default. Compatible embedding endpoints can optionally enable hybrid vector retrieval.
• Provides an interactive Dashboard for rescanning, viewing project status, organizing memories, and inspecting work activity.

Runtime scope

• The Host plugin provides workspace analysis, 13 project_* tools, persistent memory, context injection, TODOs, and architecture analysis to compatible DSH profiles.
• The Dashboard and TodoStrip are a DSH Web client plugin (platform: web). They work in DSH Web and in Desktop distributions that host the Web client.
• Pure CLI/TUI clients do not render the Dashboard. Non-Web Host compatibility is still being validated during beta and depends on the services composed by that profile.

DSH integration and installation

The package includes a Host bundle, Web Client bundle, and cordis.patch.yml. Runtime Connection RPC resolves the active workspace and supplies live data to compatible clients. Project memory is stored locally in .project-brain/; release artifacts do not contain developer workspace data.

Install the tagged GitHub beta into the DSH profile you use:

dsh plugin --profile web add github:yj-liuzepeng/dsh-project-brain#v0.7.0-beta.1

Use --profile web with dsh web, or the profile used by your DSH distribution. Restart the active DSH process after installation or upgrade; for DSH Desktop, quit and reopen the application completely. Detailed setup and troubleshooting: https://github.com/yj-liuzepeng/dsh-project-brain/blob/main/INSTALL.md

Screenshots

Project overview and architecture

Semantic architecture layers

TODOs and development timeline

Beta verification and privacy

• 12 automated smoke suites passed.
• Release/privacy scan: 16 packaged files, 0 failures.
• Clean tarball installation passed without legacy peer overrides.
• npm audit: 0 vulnerabilities.
• No project memory, credentials, logs, Session IDs, archives, or developer-machine paths are shipped.

This is the first public beta, so feedback from different DSH profiles, clients, Harness versions, and repository shapes is especially welcome. Please report reproducible issues here: https://github.com/yj-liuzepeng/dsh-project-brain/issues

[yj-liuzepeng]

Publication update: the tagged beta is live and the repository is now indexed by the unofficial MyDSH community catalog: https://mydsh.dev/plugin?repo=yj-liuzepeng%2Fdsh-project-brain

The listing exposes the GitHub install command and README. A second community-directory intake request is also under review: leenkcool/Blue-Whale-Harness#151