projectagent
DiscoveredProject agent - a DSH plugin for large projects: a project agent session, isolated task sessions and a shared file pool, with an audit trail and hand-off between stages. English version (default branc
Project agent
Project agent (projectagent) is a plugin for DSH that helps run large projects:
the main session holds the project context, the work is split into separate task sessions,
and their results and materials are collected in a shared file pool. The plugin adds a
Projects entry to the DSH sidebar: projects, their project agent sessions, the task
board and the project files.
This is an author's experiment, not a product. There are no guarantees, no license is granted, and you use it at your own risk. Details: DISCLAIMER.md.
What it is
The plugin turns a folder with materials into a project with its own structure:
- project agent session — the main session: it holds the project context, plans tasks and starts them one at a time;
- task sessions — separate sessions; each receives only its own brief, works in the project folder and submits a result to the pool; after submitting, the session frees its context;
- shared file pool
pool/— task briefs, results, shared documents and agreements; - task board — statuses, a task's plan checklist, dependencies and start order;
- journal — an audit trail of project events and agent actions;
- Usage — token and cost accounting per session and per task, two currencies, budget limits.
The technical name of the package and repository is projectagent.
Why it is needed
One long session for a large project hits the context limit and gradually loses details: what remains in memory is not the whole project but the latest messages. The plugin offers a different way of working: instead of one overloaded session — several isolated sessions with a shared file pool, an audit trail and a clear transfer of results between stages. The project memory becomes explicit and verifiable.
How it works
- You create a project: choose a folder, a name and a short description.
- The project agent reads the project memory (
pool/shared/) and plans tasks; each task is described by a brief inpool/briefs/T-XXXX.md. - A task session starts: it sees the brief and the project files, does the work and
submits a report to
pool/results/T-XXXX.md. - The result closes the task; the next task takes the ready results from the pool and continues from the same place.
- The project agent watches statuses, deadlines and context, keeps the journal and can hand itself off to a new session with a full hand-off document if the context is approaching its limit.
To keep the project from silently losing details and money, the plugin warns at 50/60/65% of the context and keeps usage records. Thresholds, budget and other parameters are configurable (see below).
Installation
The plugin is distributed through Git only (it is not published to npm):
- Open DSH → Plugins → Add plugin.
- Enter the address of the English version:
https://github.com/ra3umo/projectagent#enPinned version:https://github.com/ra3umo/projectagent#v1.0.0 - Click Install.
- Restart DSH (the Host half of the plugin is applied at start) and refresh the page.
- A Projects entry appears in the DSH sidebar; the panel page is titled Project agent.
Quick start
- Open the Projects panel → New project, choose a folder and describe the goal.
- Fill the project memory (
pool/shared/instructions.md) — the rules and agreements that must apply to every task. - Create the first task with a brief: the goal, the boundaries, what the next stage gets.
- Start the task and follow it on the board and in the journal.
- When the task completes, read the result in
pool/results/and create the next task.
Settings (briefly)
The main plugin parameters (the plugin settings page in DSH):
| Setting | What it sets |
|---|---|
projectsRoot | Projects root folder (absolute path). |
stallTimeoutMinutes | Task stall threshold in minutes; the task.stalled event and a project agent notification. |
allowedParentRoots, developerMode | Where a project may be created outside projectsRoot (nowhere by default). |
maxProjects, maxSessions | Quotas for the number of projects and sessions. |
archiveClosedSessions | Archive a task session after it is closed. |
contextLimits | Context thresholds (default 50/60/65%), warnings 5% before a threshold and the hard limit. |
tariff | Price lists for cost estimation in Usage (CNY and USD, no conversion — an estimate, not billing). |
Project settings additionally define maxParallel (one active task by default) and
allowProjectAgentDecisions — whether the project agent may make decisions at context
thresholds itself, without asking the user (by default it may not).
If you use a custom DSH preset with tools.restrict(...) and an allow-list, the plugin
tools are not included in it: list them explicitly, otherwise the agent will not see them.
Limitations and risks
- This is an experiment. No support, guarantees or maintenance commitments are provided.
- Agents change files on disk: make backups of the project folders and the DSH profile.
- Do not use the plugin with secrets, third-party personal data or critical directories.
- Agent actions are not undone automatically: deleting and editing files, running commands and sending data to the model are at your own risk.
- Token usage and cost depend on the provider; the built-in accounting is an estimate, not billing.
- The panel follows the DSH language (Russian/English); the service texts of this English version are in English.
Disclaimer
The plugin is provided "as is", without any warranties, express or implied. No license is granted: no rights are transferred, all rights are reserved by the author. If you do not accept these terms, do not install or use the plugin. Full text: DISCLAIMER.md.
Comments
Loading…
Similar plugins
by LouisHaoL
DSH plugin: host-resident scheduled-jobs × AI-agent engine (hermes-agent cron inspired) — 60s ticker fires real agent sessions via cron; pinned-session / project-workdir / default-workspace targeting;
★ 13
MIT
TypeScript
Oct 9, 2026
dsh plugin --profile web add dsh-timer-agentby lucky01222
Agent Studio for DSH Web: configure models, prompts, per-plugin tool bindings and Skills; trial-run with editable tool results and run history; preserve session capability snapshots; export standalone
★ 0
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add dsh-workbench-agent-studioby BertramWang12399
Project mode plugin for DSH Web GUI: sidebar entry, full-screen project manager, live per-project context injection (instructions + refreshable memory), session badge
★ 7
MIT
JavaScript
Sep 3, 2026
dsh plugin --profile web add dsh-projects-modeby NattoCB
Project control plane with durable tickets, replaceable DSH sessions, a project matrix, and bidirectional UI navigation.
★ 0
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add dsh-plugin-superagentby pure-craft
Deterministic project actions for people and agents — a DeepSeek Harness Web plugin. One actions.json, two surfaces: a right-sidebar panel and agent tools.
★ 6
↓ 329/wk
MIT
TypeScript
Oct 22, 2026
dsh plugin --profile web add dsh-actionsA DeepSeek Harness plugin that interviews the user about a project, generates a project timeline / Gantt chart, and exports it as Word or Excel.
★ 0
dsh plugin --profile web add dsh-plugin-project-management