deepseek-harness/packages/shell/README.md

shell/ — bash capability family

English | 中文

The capability family spans the canonical executor seam, its implementations, the shared shell environment, and the model-facing tools. All are product packages.

Package	Role	ctx key
shell/	Defines the executor contract shared by Service providers and Consumers.	ctx.shell
bash-local/	Executes commands through the local subprocess service.	(registers ctx.shell)
bash-sandbox/	Applies the configured sandbox backend before local execution.	(registers ctx.shell)
pwsh-local/	Executes PowerShell commands with Windows-specific process behavior.	(registers ctx.shell)
shell-env/	Provides the managed DSH_* environment shared by shell tools.	ctx.shellEnv
tool-bash/	Exposes Bash execution and background-job integration to the model.	(registers on ctx.tools)
tool-pwsh/	Exposes PowerShell execution to the model.	(registers on ctx.tools)

A leaf cordis.yml selects one executor implementation and the model-facing tools it needs. A sandboxed composition also selects a ctx.sandbox provider; the ACP example shows one complete wiring.

The subsystem reference — request/spec vocabulary, results, background processes, the service, and events — is docs/subsystems/shell.md.