mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Turtle ee5132c1e1 refactor(cli): dispatch web as a reserved token, drop parse machinery

Simplify the Commander adapter now that behavior can change: dispatch a leading
`web` token to its own parser instead of a subcommand of the root program, and
read opts()/processedArgs after parse() instead of action closures with a
mutable holder.

This removes enablePositionalOptions(), the parent-option leak guard, both
action closures, and the --resume/--prompt argParser threading. Behavior
changes: `dsh -p x web` is a headless prompt (extra positional dropped),
`dsh web -p x` fails loud (web has no -p), and a repeated --resume is natural
last-wins. The two real fail-loud invariants stay as post-parse checks: an empty
--resume= id (agent-loop treats '' as no-resume) and an empty -p task.

Trims args.spec.ts to the routing/fail-loud/help behavior that matters; the
tui-agent keyless PTY smoke still covers bin.ts dispatch end to end. Net ~114
fewer lines across adapter and tests.

2026-07-24 20:01:38 +08:00

src

refactor(cli): dispatch web as a reserved token, drop parse machinery

2026-07-24 20:01:38 +08:00

tests

refactor(cli): dispatch web as a reserved token, drop parse machinery

2026-07-24 20:01:38 +08:00

package.json

refactor(cli): parse dsh argv through one Commander adapter

2026-07-24 19:43:59 +08:00

README.md

refactor(cli): parse dsh argv through one Commander adapter

2026-07-24 19:43:59 +08:00

tsconfig.json

Merge latest master into tui-staging-merge-1

2026-07-22 20:45:24 +08:00

tsdown.config.ts

feat(cli): dsh CLI with personal config overlays from ~/.config/dsh

2026-07-22 14:29:28 +08:00

README.md

`@deepseek-ai/dsh`

The dsh command-line entry follows the apps/ assembly tier: apps/* are product assemblies over packages/* libraries. Plain dsh [config.yml] boots the interactive TUI coding agent, dsh -p "task" runs one headless turn, and dsh web serves the browser UI.

Argv is parsed once through a Commander adapter (src/args.ts) that resolves the invocation into a single mode; src/bin.ts switches on that mode and dynamic-imports only the chosen mode's module. dsh --help and dsh web --help render usage, dsh --version prints this app's version, and an unknown option or an invalid --host/--port/--resume value fails loud (stderr, exit 1) instead of misrouting.

The TUI surface:

boots the shipped default config (examples/tui-agent/cordis.yml) or an explicit config argument, through dsh-app-boot;
resumes a persisted session with dsh --resume <session-id> — the form the TUI prints on exit and lists under /resume; the flag sets RESUME_SESSION_ID before boot so the shipped config rehydrates that session, and a missing or unreadable id fails loud and exits nonzero;
treats the invoking directory as the workspace — sessions, relative paths, and workspace instructions resolve from the cwd;
tells the agent where its own source lives: after boot it adds a prompt section naming this harness checkout, resolved from the launcher's real path so it holds under a PATH symlink and an arbitrary cwd, so the self-referential cordis toolset can read and modify it;
applies the personal overlay from ~/.dsh (see app-boot's Personal config): .env fills environment gaps (ambient > project .env > personal .env), config.yaml patches the booted tree.

The Web surface treats its invoking directory as the default project and loads applicable AGENTS.md/CLAUDE.md instructions into each agent-loop request prefix with a 65,536-byte render budget.

Install (developer machine)

Symlink the source-running launcher onto your PATH; it resolves the checkout through its own real path, so code changes apply on the next launch with no build step:

ln -sf "$(pwd)/bin/dsh" ~/.local/bin/dsh

pnpm run demo:tui runs the same entry from the repo root. The built form (lib/bin.js, via pnpm run build) needs node --expose-internals for the shipped config's HMR entry, exactly like the demo bins.