dsh-mint
English | 中文
mint issue tracking inside DSH sessions: a
session starts knowing what is open, every change gets registered, and a host
plan always has a mint plan behind it.
What it does
- Session context — every session opens with a
[Mint] overview: the top
open issues, the running milestone, and the rule that new plans and standalone
issues attach to it.
mint tool, zero approval — the agent runs the whole mint CLI through a
host tool: mint is spawned inside the plugin process, so there is no bash
call, no sandbox write access and no approval prompt. Subagents inherit the
tool too (their bash is pinned to never). Destructive subcommands (delete,
import, sync, export, tui) and the global --db / --project flags
are refused.- Plan-mode binding —
exit_plan_mode is refused while the project has no
active mint plan, so a host plan cannot drift away from its mint plan.
- Reminders — after a
git commit the agent is reminded to register it
(issue state commit --sha); a failed tool call suggests filing an issue.
- Bundled mint skill — the
mint skill shipped in this package is
content-synced into $DSH_HOME/skills/mint on load, so the agent knows the
issue/plan/milestone workflow without a manual skill install.
- bash fallback gate — if the tool is ever unavailable, the first mint
sandbox escalation of a session is approved once and later ones pass
automatically;
autoApprove: true skips even that first prompt.
Model-facing text — the injected overview and the reminders — is currently
written in Chinese.
Requirements
- DSH (
@deepseek-ai/dsh); the host interfaces are verified against 0.1.1-rc.2
- Node.js >= 20
- No global mint install: the plugin resolves the mint CLI through its own
mint-faa dependency
Install
Installing the package into a profile also mounts it. The package declares its
own DSH bundle patch (dsh.bundle.patch), so dsh plugin reconciles the
profile's layer list by installed state — there is no YAML to edit by hand.
Restart DSH afterwards.
From npm
dsh plugin --profile web add @yanqd0/dsh-mint
web is the profile behind dsh web; any other profile name works the same.
dsh plugin runs pnpm inside ~/.dsh/profiles/web. pnpm 11 blocks dependency
build scripts by default and exits with ERR_PNPM_IGNORED_BUILDS. Approve the
builds with pnpm itself, without editing any YAML, then re-run the install:
dsh plugin --profile web approve-builds --all
dsh plugin --profile web add @yanqd0/dsh-mint
If you prefer a single command and accept allowing all builds during install:
dsh plugin --profile web add @yanqd0/dsh-mint --config.dangerouslyAllowAllBuilds=true
From GitHub Packages
The same @yanqd0/dsh-mint name is published to both registries. GitHub
Packages requires authentication even for public packages, using a personal
access token (classic) with the read:packages scope. Add both lines to
~/.npmrc (or to ~/.dsh/profiles/<profile>/.npmrc):
@yanqd0:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
Then install the same way:
dsh plugin --profile web add @yanqd0/dsh-mint
From source (development)
git clone https://github.com/yanqd0/dsh-mint.git
cd dsh-mint
pnpm install && pnpm build
dsh plugin --profile web add ./
Verify
dsh --profile web --dump-config | grep -c "id: mint" # must be 1
The plugin is mounted when id: mint appears exactly once and no patch:
warning is printed. A duplicated mount (a hand-written insert line left in the
profile patch while the bundle patch is also active) shows up as a count of 2 and
fails at boot with duplicate loader entry id: mint.
Usage
Start a session in a project tracked by mint: the [Mint] overview is injected
on the first turn and the bundled skill teaches the agent the issue → plan →
milestone workflow. Ask in plain language ("what should we do next?", "record
this bug") and the agent drives mint through the mint tool — the same calls
you can ask for explicitly:
| Request | Tool call behind it |
|---|
| list open issues | mint({args:["list"]}) — one TSV page of 5 |
| file a bug | mint({args:["issue","add","<title>","--kind","problem"]}) |
| start work on an issue | mint({args:["issue","state","start","42"]}) |
| close a plan after tests | mint({args:["plan","close","7","--test-cmd","<command>"]}) |
Any subcommand is reachable, and mint({args:["<subcommand>","--help"]}) returns
the mint help verbatim.
Configuration
| Option | Default | Effect |
|---|
autoApprove | false | Auto-allow mint sandbox escalations (bash fallback) without any prompt — an explicit trust of the mint CLI. |
autoInstallSkill | true | Content-sync the bundled mint skill into $DSH_HOME/skills/mint on plugin load. |
debug | false | Reserved for verbose plugin diagnostics. |
Override them in the profile's own patch layer (~/.dsh/profiles/<profile>/cordis.patch.yml).
An entry with the same id patches the mounted row instead of mounting a second
one — the option you omit keeps its default:
- id: mint
config:
autoApprove: true
Roadmap
0.2.0 adds the client face: a mint tab in the conversation area with an issue
panel, backed by host RPC queries.
Development
pnpm dev # run the plugin entry with tsx
pnpm build # tsup + skill copy → dist/
pnpm test # vitest
pnpm lint # ESLint
pnpm check-types # tsc --noEmit
AGENTS.md is the project navigation (Chinese) for AI coding
agents: layout, hard constraints and architecture facts. notes/ holds the
internal Chinese engineering notes, docs/ the future English documentation.
License
MIT
