Overview
dsh-mini is a portable engine for the DeepSeek Harness core and a terminal coding agent CLI that can work on a phone. The project states it is not a fork: it assembles pi (the shell) and DSH (the engine) as an npm consumer, while the repository's own work is the five seams, compatibility layer, and documentation. The engine comes unchanged from official DSH packages, including event-sourced sessions, a turn/step state machine, tool scheduling, compaction, and skills. The shell uses the pi ecosystem, including the @earendil-works/pi-tui framework and the @openguardrails/dsh-tui full-screen interface by default.
The project reduces dependencies compared with official DSH. It reports 39 build-time direct dependencies, 31 default profile plugins, 0 runtime npm dependencies, a 7.7 MB single-file install, and a 419 KB portable engine with zero Node builtins. It is intended to be Termux-friendly: recommended Node >= 22.15 because zstd is built into node:zlib, with no native modules or compilation; older Node can run but sessions degrade to uncompressed JSONL. Installation is a single curl | sh command that downloads a self-contained file and a 26-line launcher, without npm. The bash tool directly accesses the phone's real filesystem, and data and keys stay local on the phone.
dsh-mini exposes five seams for replacing provider, filesystem, persistence, and UI while keeping the engine unchanged. It supports LLM adapters including official DeepSeek direct connection, official pi-ai multi-provider (OpenAI/Anthropic/OpenRouter), and a self-written Gemini reference implementation. Persistence uses the official JSONL backend plus a compatibility layer with Android-specific fixes. The repository includes ARCHITECTURE.md, DECISIONS.md, skills, a conformance gate, and AGENTS.md to support reassembly and extension. The CLI has minimal and standard modes, settings files, toolpackages, and renderer modes for full-screen TUI, basic shell, or plain text.
Pricing
Free
Detailed plans have not been confirmed in our catalog. Check the official website for current limits and billing terms.
Visit WebsitePrices and limits may change. Confirm the currency, billing period, seat minimum and usage caps on the official website.
Use Cases
- Developers use dsh-mini to run a coding agent on a phone and let its bash tool operate on the real filesystem.
- Teams use dsh-mini to install a self-contained CLI without npm.
- Developers use dsh-mini to switch LLM providers through the adapter seam.
- Teams use dsh-mini to keep sessions and API keys local on the device.
- Developers use dsh-mini to add custom tools via toolpackages.
- Teams use dsh-mini to run conformance tests against upstream engine changes.
- Developers use dsh-mini to embed the portable engine in other hosts.
- Teams use dsh-mini to select minimal or standard tool modes.
Features
Terminal-based coding agent
DeepSeek Harness core engine
Termux-friendly command-line interface
Single-file portable package
No runtime dependencies
Lightweight 7.6 MB build
Reviews
No reviews yet. Be the first to share your experience!