d.sh

A minimal coding agent for DeepSeek-compatible APIs, all in one Bash file: d.sh. It requires only Bash 4.3+ and curl. On minimal servers without a full dependency stack, it can bootstrap a more capable harness (Codex, Claude Code, DeepSeek Harness) or handle simple environment setup — serving as a bootloader agent.

Quick Start

Run once without saving the script or configuration:

DEEPSEEK_API_KEY='your-api-key' bash <(curl -fsSL https://raw.githubusercontent.com/SiriusNEO/d.sh/main/d.sh)

Save a configured copy and keep using it:

curl -fsSL https://raw.githubusercontent.com/SiriusNEO/d.sh/main/d.sh -o d.sh
bash d.sh

The first command downloads the script as d.sh in the current directory; any existing copy is overwritten. The second runs it and starts an interactive setup for BASE_URL, MODEL_NAME, and DEEPSEEK_API_KEY, then drops you into the interactive prompt. The chosen values are written back into d.sh with mode 600, so later runs only need bash d.sh.

Configuration

The three connection settings are:

Variable	Purpose
DEEPSEEK_API_KEY	API key; required
BASE_URL	DeepSeek-compatible API endpoint
MODEL_NAME	Model sent with each request

BASE_URL defaults to https://api.deepseek.com and MODEL_NAME to deepseek-v4-flash. DEEPSEEK_API_KEY is always required. During interactive setup, press Enter to keep the displayed default; API-key input is hidden. When setup runs from a saved copy, the selected values are written back to d.sh and the file mode is changed to 600.

Other harness settings (DSH_*) are documented in the configuration block at the top of d.sh. Environment variables override values stored in the script and become the defaults shown during interactive setup.

Sessions

The conversation is saved to session.jsonl in the working directory and resumed automatically on the next run. Each line contains the role, a tab, and the message JSON. /clear empties the file. Set DSH_SESSION_FILE to another path, or to an empty value to disable persistence.

Only complete turns are written, so an interrupted run never resumes on a half-finished tool exchange.

Tools

Tool	Description
bash	Persistent shell — cwd, environment, functions and virtualenvs survive across calls and turns
str_replace_editor	view / create / str_replace / insert on text files

Interactive commands

• /compact — summarize older history
• /clear — reset the conversation and persistent shell
• /exit — quit
• Ctrl+C — cancel the in-flight model request or running command and return to the prompt; a running command also resets the persistent shell
• Ctrl+D — quit (same as /exit)

Security

Commands run with your permissions and without a sandbox. Interactive setup stores the API key in the local d.sh; never commit or share that configured copy. Session files contain the full conversation and should also remain outside version control.

Acknowledgements

An independent implementation inspired by deepseek-ai/deepseek-harness (MIT); the persona and tool schemas are adapted from its sdk-minimal bundle (MIT).