gitwtfhub

wtf is deepseek-reasonix?

esengine/deepseek-reasonix — explained in plain English

Analysis updated 2026-08-13

34,392GoAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A terminal based AI coding agent built for DeepSeek's models, tuned to reuse conversation history so long coding sessions cost much less.

Mindmap

mindmap
  root((repo))
    What it does
      Terminal AI agent
      DeepSeek only
      Cache first design
    Tech stack
      Node.js
      TypeScript
      Go rewrite
      Tauri desktop
    Use cases
      Long coding sessions
      Low cost inference
      Remote via QQ
    Audience
      Developers
      DeepSeek users
    Setup
      Needs API key
      Node 22 plus

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run an AI agent in your terminal that edits your codebase only after you approve each change

REASON 2

Keep a long running coding session open so DeepSeek's prefix cache keeps token costs low

REASON 3

Use the desktop app to see which files the agent touched plus live cost and token counters

REASON 4

Continue an active coding session remotely through a connected QQ chat

What's in the stack?

Node.jsTypeScriptGoDeepSeek APITauri

How it stacks up

esengine/deepseek-reasonixfilebrowser/filebrowserehang-io/nps
Stars34,39234,58434,044
LanguageGoGoGo
Setup difficultymoderateeasyeasy
Complexity3/51/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a DeepSeek API key and Node.js 22 or later.

Wtf does this do

DeepSeek-Reasonix is a command line coding agent built specifically for DeepSeek's models. You install it with npm and run it inside a project folder, where it reads your code, proposes edits, and applies them only when you approve. The tool is designed around a technical detail of DeepSeek's API called prefix caching: if you keep the same conversation running instead of starting fresh sessions, DeepSeek can reuse the earlier part of the prompt and charge much less for it. The README shows a real user's numbers from a single day: 435 million input tokens processed, with 99.82 percent of that traffic served from cache, bringing the bill to around 12 dollars instead of the roughly 61 dollars it would have cost without caching. To use it, you need Node.js version 22 or later and your own DeepSeek API key, which you paste in on first run. The main command is reasonix code, which starts the agent in your project directory. A shorter dsnix alias does the same thing if you prefer fewer keystrokes. Other commands include reasonix chat for plain conversation without file or shell access, reasonix run for one shot tasks that print to the terminal, and reasonix doctor for checking that your setup, meaning Node version, API key, and any connected tools, is working correctly. Beyond the terminal, the project also has a prerelease desktop app built with Tauri that shows the same session in a graphical window, including which files the agent has touched and running cost and token counters. There is also a QQ chat integration that lets you continue a session through the QQ messaging app once connected. This repository is described as the older TypeScript version of the project, now in maintenance mode only for bug fixes. Active development has moved to a separate Go based rewrite on another branch. With over 34,000 stars, it has an active community with a bilingual English and Chinese Discord server for setup help and feature discussion.

Yoink these prompts

Prompt 1
Install reasonix globally with npm and start it in my project so I can review edits before they apply
Prompt 2
Set up my DeepSeek API key with reasonix and explain how the prefix cache savings work in a long session
Prompt 3
Compare reasonix chat mode and reasonix code mode and tell me when to use each one
Prompt 4
Walk me through installing the Reasonix desktop app and connecting it to the same session as the CLI

Frequently asked questions

wtf is deepseek-reasonix?

A terminal based AI coding agent built for DeepSeek's models, tuned to reuse conversation history so long coding sessions cost much less.

What language is deepseek-reasonix written in?

Mainly Go. The stack also includes Node.js, TypeScript, Go.

How hard is deepseek-reasonix to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is deepseek-reasonix for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.