# DeepSeek-Reasonix — DeepSeek-Native Terminal Coding Agent

> A terminal coding agent engineered specifically around DeepSeek models and their prefix-cache stability. Built in TypeScript with ink for the TUI, it optimizes for long-running sessions where cache hit rates matter.

## Install

Save in your project root:

# DeepSeek-Reasonix — DeepSeek-Native Terminal Coding Agent

## Quick Use
```bash
git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
npm install
npm run build
npx deepseek-reasonix
```

## Introduction
DeepSeek-Reasonix is a terminal coding agent designed from the ground up around DeepSeek models and their prefix caching behavior. Unlike general-purpose agents that treat all LLM providers equally, Reasonix structures its prompts and sessions to maximize DeepSeek's cache hit rate, resulting in lower latency and cost over extended coding sessions.

## What DeepSeek-Reasonix Does
- Provides a TUI coding agent optimized for DeepSeek R1 and related models
- Structures prompts to maximize prefix cache stability across turns
- Supports file reading, writing, searching, and shell command execution
- Includes a session system designed for long-running development tasks
- Renders rich terminal output with syntax highlighting and diff views

## Architecture Overview
DeepSeek-Reasonix is a TypeScript application using the ink framework for its terminal UI. The core innovation is a prompt construction layer that keeps a stable prefix across conversation turns, aligning with DeepSeek's prefix caching mechanism. Tool use follows the standard function-calling pattern. State is managed in memory during a session and persisted to disk between sessions.

## Self-Hosting & Configuration
- Requires Node.js 18+ and a DeepSeek API key
- Install dependencies with npm install and build with npm run build
- Set DEEPSEEK_API_KEY in your environment or in a .env file
- Configure model selection and temperature in the config file
- Supports custom system prompts for project-specific instructions

## Key Features
- Prefix-cache-aware prompt construction for lower latency and cost
- Purpose-built for DeepSeek R1 reasoning capabilities
- ink-based TUI with responsive terminal rendering
- File and shell tool use for autonomous code changes
- Session persistence for resuming long-running tasks

## Comparison with Similar Tools
- **Claude Code** — optimized for Claude models; Reasonix is DeepSeek-native
- **Aider** — model-agnostic, no cache optimization; Reasonix maximizes DeepSeek cache hits
- **CodeWhale** — Rust-based, local-model focus; Reasonix targets DeepSeek API specifically
- **OpenCode** — Go-based general agent; Reasonix adds DeepSeek-specific prompt engineering

## FAQ
**Q: Does it work with non-DeepSeek models?**
A: It is designed for DeepSeek. Other OpenAI-compatible models will function but won't benefit from the prefix cache optimizations.

**Q: What is prefix cache stability?**
A: DeepSeek caches computed prefixes. Reasonix keeps the beginning of each prompt identical across turns so the cache is reused, reducing processing time and cost.

**Q: Is it free to use?**
A: The tool is open source. You pay for DeepSeek API usage based on their pricing.

**Q: Can I use it offline with a local DeepSeek model?**
A: Yes, if you run a local DeepSeek-compatible server, point the endpoint configuration to it.

## Sources
- https://github.com/esengine/DeepSeek-Reasonix

---
Source: https://tokrepo.com/en/workflows/asset-eb724f54
Author: AI Open Source