Skip to content

Repository files navigation

codsh — a terminal coding agent on the DeepSeek Harness

Site · npm · English | 中文

npm: codsh-cli · command: codsh

A terminal coding agent on the DeepSeek Harness. /ship takes one sentence to verified code.

Install

npm install -g @deepseek-ai/dsh codsh-cli   # already have dsh? npm i -g codsh-cli
codsh

Zero-dependency launcher. codsh is dsh --profile code. Key: DEEPSEEK_API_KEY.

codsh --resume <id> · codsh --continue · codsh -p "task"

Or skip the launcher:

dsh plugin --profile code add codsh-bundle
dsh --profile code

/ship

The /ship flow

/ship <one-sentence idea> — grill, two approvals, then autonomous:

  1. Grill — design-tree interview; facts are inspected, each round asks the open frontier with a recommended answer.
  2. Spec — synthesized automatically (to-spec). You confirm. Each criterion names its proving command.
  3. Tickets — tracer-bullet slices, written automatically. You approve. Baseline runs before any code.
  4. Landing — TDD at the spec's seams; each green ticket is a commit.
  5. Done — every criterion re-run and reported.

Bare /ship resumes an unfinished spec.

/ship let long diffs open in a pager instead of scrolling past

The surface

The site shows each live. In brief:

  • Alternate screen; box pinned at the bottom; quit restores your shell.
  • Long blocks fold; click one, Ctrl+O all; hover names it.
  • Todos stay in chrome (Ctrl+T / /todos).
  • Drag to copy. Markdown, thinking, and tool cards stream in.
  • Ctrl+V pastes images (native vision, or a file + optional sidecar).
  • / commands, $ skills, ! shell, @ files — menu sits above the box.
  • Approvals and /model /resume are arrow-key widgets. ⇧Tab is plan mode.
  • /clear, /resume, Esc Esc, /init. !cmd prints in-session and the agent sees it.

Off a TTY it becomes a line reader: no widgets, no drawing.

Development

pnpm install
pnpm run dev                 # build → .dev-home → boot
MOCK=markdown pnpm run dev   # keyless, against the e2e mock
pnpm test
pnpm run test:e2e            # pack, install, drive the real binary

pnpm run sync:dsh tracks published @deepseek-ai/dsh-* releases. This repo never forks the harness.

License

MIT

About

One sentence to shipped — a terminal coding agent built around /ship, on the DeepSeek Harness

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages