# DeepSeek-Reasonix Example Projects and Use Cases: 9 Production Workflows Explained > Explore DeepSeek-Reasonix example projects and use cases. Discover 9 production workflows for AI coding agents, from CLI assistants to CI/CD automation. - Repository: [YHH/DeepSeek-Reasonix](https://github.com/esengine/DeepSeek-Reasonix) - Tags: use-cases - Published: 2026-08-14 --- **DeepSeek-Reasonix is a single-binary AI coding agent with nine documented use cases ranging from interactive CLI assistants to CI/CD automation, all implemented through a config-driven, plugin-based architecture.** DeepSeek-Reasonix is designed as a highly extensible, locally-runnable AI engine. Its architecture is intentionally **config-driven** and **plugin-driven**, enabling the same binary to power diverse workflows without code changes. Below are the most common DeepSeek-Reasonix use cases, each mapped to specific implementation files in the `esengine/DeepSeek-Reasonix` repository. --- ## Interactive Coding Assistant (CLI/TUI) **The CLI provides a REPL-style chat for on-the-spot code generation, editing, and debugging.** Run `reasonix run ""` to parse commands, handle tool approvals, and maintain persistent sessions with checkpoints. Key implementation details: - [`README.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/README.md) — installation and quick-start guide [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/README.md) - [`docs/GUIDE.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/GUIDE.md) — CLI usage patterns [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/GUIDE.md) ```bash # Start an interactive session reasonix # Inside the REPL, initialize and run a task /init reasonix run "write a function that computes the Fibonacci sequence" ``` --- ## Desktop GUI Application **A native desktop app for macOS, Windows, and Linux with drag-and-drop and rich formatting.** The desktop build uses the **Wails framework** (`desktop/`), embeds the same engine binary, and adds UI-specific hooks. Relevant files: - [`desktop/README.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/desktop/README.md) — desktop prerequisites [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/desktop/README.md) - [`desktop/third_party/go-webview2/webviewloader/README.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/desktop/third_party/go-webview2/webviewloader/README.md) — Windows webview loader [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/desktop/third_party/go-webview2/webviewloader/README.md) --- ## VS Code Integration via ACP **The Agent Communication Protocol (ACP) enables editor integration as a language-server-like service.** Run `reasonix acp` to start a stdio server. Editors connect and receive tool approvals, permissions, and incremental updates. Implementation: [`docs/ACP.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/ACP.md) — full ACP integration guide [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/ACP.md) ```bash # Start the ACP server reasonix acp # VS Code "Reasonix Agent" extension connects automatically # Invoke /run or /tool commands from the editor ``` --- ## Long-Running Autonomous Tasks **Execute multi-step projects with planning, checkpointing, and goal tracking.** The engine supports **Plan mode**, checkpointing, and **Goal** tracking to maintain context across many turns. Key implementations: - [`docs/GOAL_ENFORCEMENT.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/GOAL_ENFORCEMENT.md) — goal handling orchestration [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/GOAL_ENFORCEMENT.md) - [`docs/CHECKPOINTS.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/CHECKPOINTS.md) — checkpoint mechanics [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/CHECKPOINTS.md) ```bash # Headless goal execution with auto-approval reasonix run --auto \ --goal "implement a REST API for a todo list in Go" # Checkpoints saved under ~/.reasonix/sessions/… ``` --- ## CI/CD Pipeline Integration **Run DeepSeek-Reasonix in headless mode for automated code generation and fixes.** The CLI provides **auto permission mode** that skips interactive prompts, plus a sandbox enforcing file-write boundaries. Implementation details: - [`docs/CLI.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/CLI.md) — headless flags and commands [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/CLI.md) - [`internal/workspacelease/lease.go`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/internal/workspacelease/lease.go) — sandbox enforcement logic [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/internal/workspacelease/lease.go) --- ## Remote SSH Development **Invoke DeepSeek-Reasonix on remote hosts while interacting locally.** The remote configuration boots `reasonix serve` on the remote machine, tunnels the web UI, and keeps tools running on the host. Implementation: [`docs/REMOTE.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/REMOTE.md) — remote SSH guide [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/REMOTE.md) --- ## Plugin Development with MCP **Extend DeepSeek-Reasonix via the Managed-Code-Plugins (MCP) protocol.** Plugins are separate executables exposing a **JSON RPC interface**. The engine loads them at startup and routes tool calls through the sandbox. Key resources: - [`docs/EXTENSION_PROTOCOL.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/EXTENSION_PROTOCOL.md) — protocol specification [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/EXTENSION_PROTOCOL.md) - [`sdk/go/README.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/sdk/go/README.md) — Go SDK for building plugins [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/sdk/go/README.md) ```toml # reasonix.toml configuration [[plugins]] name = "weather" command = "my-weather-tool" ``` ```bash # Call the plugin from a session /tool weather get_current location="San Francisco" ``` --- ## Multi-Model Collaboration **Run planner and executor models simultaneously, or delegate to specialized agents.** Configuration supports specifying a planner (`[agent].planner_model`) and per-sub-agent models for **two-model reasoning flows**. Implementation: [`docs/GUIDE.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/GUIDE.md) — model configuration section [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/GUIDE.md#configuration) --- ## Research and Experimentation **Explore reasoning strategies, tool contracts, and prompt engineering via the "Superpowers" sandbox.** The repository includes design docs for modifying system prompts, adding custom tool schemas, and testing new behaviors. Implementation: [`docs/superpowers/README.md`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/docs/superpowers/README.md) — researcher documentation [source](https://github.com/esengine/DeepSeek-Reasonix/blob/main-v2/docs/superpowers/README.md) --- ## Complete Installation and Quick Start ```bash # Install via npm (cross-platform) npm i -g reasonix # Or on macOS via Homebrew brew install esengine/reasonix/reasonix # Verify installation reasonix --version ``` --- ## Summary - **DeepSeek-Reasonix** ships as a single binary adapting to CLI, desktop, editor, CI, remote, and plugin contexts - **Nine core use cases** are implemented through config-driven architecture without code changes - **ACP protocol** (`reasonix acp`) enables VS Code and editor integration - **Headless mode** (`--auto` flag) supports CI/CD automation with sandboxed file writes - **MCP protocol** allows custom plugin development via JSON RPC - **Checkpointing and goal tracking** enable long-running autonomous tasks - **Remote SSH workflows** via `reasonix serve` support distributed development --- ## Frequently Asked Questions ### What is the fastest way to try DeepSeek-Reasonix? Install the pre-built binary with `npm i -g reasonix` or `brew install esengine/reasonix/reasonix`, then run `reasonix` to open the interactive REPL. No additional dependencies or model setup is required for basic usage. ### Can DeepSeek-Reasonix run entirely offline? Yes. DeepSeek-Reasonix is designed for local execution. The binary embeds the core engine and can run with local models. Remote SSH and ACP modes require network connectivity only for the specific connection, not for the engine itself. ### How does editor integration differ from the desktop app? The **desktop app** (`desktop/`) provides a standalone graphical interface with Wails. **ACP integration** (`reasonix acp`) runs as a stdio server that editors like VS Code connect to, offering tighter integration with your existing workflow and file context. ### What sandbox protections exist for autonomous execution? The [`internal/workspacelease/lease.go`](https://github.com/esengine/DeepSeek-Reasonix/blob/main/internal/workspacelease/lease.go) implementation enforces file-write boundaries and permission controls. In `--auto` mode, operations are constrained by lease-based sandbox rules, preventing uncontrolled modifications outside designated workspaces.