deep-projects 0.0.0-stage → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +123 -2
- package/cordis.patch.yml +7 -0
- package/icon.svg +4 -0
- package/lib/client.js +1770 -0
- package/lib/index.js +841 -0
- package/package.json +97 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Johannes Tebbert
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,124 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/banner.svg" alt="deep-projects: project rooms for the DeepSeek Harness web GUI with a goal, memory, instructions and knowledge" width="100%">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://www.npmjs.com/package/deep-projects"><img src="https://img.shields.io/npm/v/deep-projects?color=4d6bfe&label=npm" alt="npm version"></a>
|
|
7
|
+
<a href="https://www.npmjs.com/package/deep-projects"><img src="https://img.shields.io/npm/dm/deep-projects?color=4d6bfe" alt="npm downloads"></a>
|
|
8
|
+
<img src="https://img.shields.io/badge/dependencies-0-4d6bfe" alt="zero runtime dependencies">
|
|
9
|
+
<a href="https://github.com/JoblessJoe/deep-projects/blob/main/LICENSE"><img src="https://img.shields.io/github/license/JoblessJoe/deep-projects?color=4d6bfe" alt="MIT license"></a>
|
|
10
|
+
<a href="https://joblessjoe.com/deep-projects"><img src="https://img.shields.io/badge/website-joblessjoe.com-4d6bfe" alt="project page on joblessjoe.com"></a>
|
|
11
|
+
<a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-0b6bcb" alt="dsh-plugin topic"></a>
|
|
12
|
+
</p>
|
|
13
|
+
|
|
14
|
+
A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) web GUI plugin that gives every project **its own room**: a goal, custom instructions, knowledge files and a memory your agents keep up to date. Start a chat in the room and the agent already knows the project. You never explain it twice. Think Claude Desktop's Projects, built for dsh and your local models.
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npx @deepseek-ai/dsh plugin --profile web add deep-projects
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Then restart your dsh web server and reload the tab. **Projects** appears in the sidebar. Full details under [Install](#install).
|
|
21
|
+
|
|
22
|
+
<p align="center">
|
|
23
|
+
<img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/projects-page.png" alt="The Projects page: project list on the left; goal, memory, knowledge files and instructions on the right" width="100%">
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
|
+
<p align="center">
|
|
27
|
+
<img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/sidebar.png" alt="Pinned projects in the dsh sidebar with their … menu open" width="430">
|
|
28
|
+
<br><sub>Pinned projects sit in the sidebar. The "…" menu opens, edits, pins, archives or deletes a project.</sub>
|
|
29
|
+
</p>
|
|
30
|
+
|
|
31
|
+
## What's in a room
|
|
32
|
+
|
|
33
|
+
- **Goal**: what the project is for and what done looks like. Every chat sees it.
|
|
34
|
+
- **Memory**: facts, decisions and preferences, one bullet each. You add and edit them; agents add new ones as they learn and fix stale ones. Every chat sees it.
|
|
35
|
+
- **Custom instructions**: the project's `AGENTS.md`, edited in place.
|
|
36
|
+
- **Knowledge files**: drag and drop docs, specs and references for the agent to read.
|
|
37
|
+
- **Chats**: every chat started from the project runs in its folder and is listed under it.
|
|
38
|
+
|
|
39
|
+
## Features
|
|
40
|
+
|
|
41
|
+
- **Projects page** with a filterable project list and one page per project.
|
|
42
|
+
- **Pinned projects in the sidebar**, styled like dsh's own rows. Click to open, or use the arrow to show the project's chats.
|
|
43
|
+
- **"…" menus** that match dsh's: open, new chat, edit, pin, archive, delete. Chat rows get dsh's usual chat menu.
|
|
44
|
+
- **Edit in place**: name, description and goal.
|
|
45
|
+
- **Archive**: hide finished projects without deleting anything. Restore any time.
|
|
46
|
+
- **Project tab** in the right sidebar of every chat that belongs to a project, plus a folder button in the chat header.
|
|
47
|
+
- **8 agent tools**, so agents can read and maintain projects themselves (see below).
|
|
48
|
+
- English and Chinese, light and dark theme, works on narrow screens. No runtime dependencies.
|
|
49
|
+
|
|
50
|
+
## How it works
|
|
51
|
+
|
|
52
|
+
Each project is a plain folder:
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
~/deep-projects/<slug>/
|
|
56
|
+
AGENTS.md custom instructions
|
|
57
|
+
AGENTS.local.md goal + memory
|
|
58
|
+
README.md description
|
|
59
|
+
knowledge/ your files
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
dsh already loads `AGENTS.md` and `AGENTS.local.md` from a chat's working folder. Chats started from a project run in that folder, so the goal, memory and instructions reach the model **natively, with no prompt injection**. Everything is plain markdown: read it, edit it by hand, or commit it to git.
|
|
63
|
+
|
|
64
|
+
- **Host**: JSON routes under `/api/deep-projects/` on the dsh web server, plus the agent tools. All file access stays inside the projects folder.
|
|
65
|
+
- **Client**: one self-contained bundle. It uses dsh's own design tokens, icons and context menus, so it looks native in both themes.
|
|
66
|
+
|
|
67
|
+
## Agent tools
|
|
68
|
+
|
|
69
|
+
| Tool | What it does |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| `projects_list` | List projects |
|
|
72
|
+
| `projects_create` | Create a project |
|
|
73
|
+
| `projects_read` | Read goal, instructions, memory and the knowledge list |
|
|
74
|
+
| `projects_update` | Change name, description, goal, instructions, pin or archive state |
|
|
75
|
+
| `projects_add_note` | Add one memory |
|
|
76
|
+
| `projects_set_memory` | Rewrite the memory list (fix, merge or remove entries) |
|
|
77
|
+
| `projects_add_knowledge` | Copy a file into the project's knowledge |
|
|
78
|
+
| `projects_delete` | Delete a project (its chats are kept) |
|
|
79
|
+
|
|
80
|
+
The memory file tells agents to keep it current, so they record new facts without being asked.
|
|
81
|
+
|
|
82
|
+
## Install
|
|
83
|
+
|
|
84
|
+
Into your dsh **web profile** (`web` below is the profile name; use whichever profile backs your web GUI). From a source checkout, use `pnpm dsh` instead of `npx @deepseek-ai/dsh`:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
npx @deepseek-ai/dsh plugin --profile web add deep-projects
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Restart the dsh web server afterwards (the plugin adds a new profile entry), then reload the browser tab.
|
|
91
|
+
|
|
92
|
+
Other sources:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# straight from GitHub
|
|
96
|
+
npx @deepseek-ai/dsh plugin --profile web add github:JoblessJoe/deep-projects
|
|
97
|
+
# from a local checkout
|
|
98
|
+
npx @deepseek-ai/dsh plugin --profile web add file:/path/to/deep-projects
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
**Projects folder**: `~/deep-projects` by default. Set `DSH_PROJECTS_ROOT` in the dsh server's environment to use another folder.
|
|
102
|
+
|
|
103
|
+
**Requirements**: the dsh web GUI, dsh 0.2.2 or newer (`engines.dsh`: `>=0.2.2-rc.1 <0.4.0-0`), Node 20+.
|
|
104
|
+
|
|
105
|
+
### Sidebar chat tree (optional)
|
|
106
|
+
|
|
107
|
+
On stock dsh, pinned projects show up as plain sidebar rows that open the project. dsh has no plugin seat yet for a block between the panel rows and the workspace list, so the expandable version (arrow, chats underneath, "…" menu right in the sidebar) needs a small `ui-sidebar` patch: [`patches/ui-sidebar-projects-seat.patch`](https://github.com/JoblessJoe/deep-projects/blob/main/patches/ui-sidebar-projects-seat.patch). With it applied, the plugin switches to that view by itself. Everything else works without it.
|
|
108
|
+
|
|
109
|
+
A second small patch, [`patches/ui-conversation-cwd-hero.patch`](https://github.com/JoblessJoe/deep-projects/blob/main/patches/ui-conversation-cwd-hero.patch), gives project chats dsh's full input on the new chat screen. Stock dsh locks that input for chats outside a workspace, so without the patch the plugin shows its own simple box for the first message. I've [asked dsh](https://github.com/deepseek-ai/deepseek-harness/discussions/14029) to drop the lock.
|
|
110
|
+
|
|
111
|
+
**Let your agent do it:** give your coding agent [`patches/AGENT-INSTRUCTIONS.md`](https://github.com/JoblessJoe/deep-projects/blob/main/patches/AGENT-INSTRUCTIONS.md). It checks your dsh version, applies the patches, rebuilds the changed packages and tells you when to restart. The patch needs a dsh source checkout; it can't be applied to an npm-installed dsh.
|
|
112
|
+
|
|
113
|
+
## Develop
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
npm install
|
|
117
|
+
npm run build # lib/index.js (host) + lib/client.js (web)
|
|
118
|
+
node scripts/smoke.mjs # routes + agent tools against a temp folder
|
|
119
|
+
DSH_REPO=/path/to/deepseek-harness node scripts/validate-tools.mjs # dsh's real tool validator
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## License
|
|
123
|
+
|
|
124
|
+
MIT
|
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# deep-projects bundle mount.
|
|
2
|
+
# A NEW plugin contributes a brand-new profile entry, so the row is an `insert:`
|
|
3
|
+
# (a bare `- id:` would patch an existing entry by id and fail silently).
|
|
4
|
+
# Adding a new `insert:` requires a web-server restart to take effect.
|
|
5
|
+
- insert:
|
|
6
|
+
- id: deep-projects
|
|
7
|
+
name: 'deep-projects'
|
package/icon.svg
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
|
|
2
|
+
<path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7z"/>
|
|
3
|
+
<path d="M3 11h18" opacity="0.5"/>
|
|
4
|
+
</svg>
|