explaingit

zs520l/hanakopro

13JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A Windows desktop AI coding companion that reads and edits files, runs terminal commands, and remembers across sessions, with inline diff views for file changes, real-time streaming writes, and fully editable system prompts.

Mindmap

mindmap
  root((repo))
    What it does
      AI coding companion
      Windows desktop app
      File and terminal access
    Key Features
      Inline diff view
      Real-time file writing
      Terminal output in chat
    Conversation Control
      Retract sent messages
      Add instruction mid-reply
      Better interruption handling
    Memory System
      Per-item display
      Jump to source turn
    Customization
      Editable system prompts
      Tool descriptions exposed
      Desktop companion figure
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Ask an AI to edit code files on your computer and immediately see the before-and-after diff inside the same chat window.

USE CASE 2

Run terminal commands through the AI and watch the output stream directly into the conversation without switching windows.

USE CASE 3

Retract a mistaken instruction and replace it with the correct one before the AI acts on the wrong request.

USE CASE 4

Edit the AI's system prompt directly to customize its behavior with no hidden default instructions.

Tech stack

JavaScriptNode.jsnpm

Getting it running

Difficulty · easy Time to first run · 5min

Running from source requires Node.js 22+ and npm 10+, the Windows installer handles everything for standard end-user installation.

Use freely for any purpose including commercial use, as long as you include the required notices.

In plain English

HanakoPro is a Windows desktop application that lets you have conversations with an AI assistant while it can also read and edit files on your computer, run terminal commands, and remember things across sessions. It is a modified version of an open-source project called Hanako, built on top of version 0.194.2 of that project. The README is written in Chinese, and the app appears aimed at developers and graduate students who want a more capable daily AI coding companion. The main additions over the original Hanako are practical quality-of-life improvements for people who use AI to write or edit code. When the AI changes a file, HanakoPro shows the before-and-after differences side by side in the chat window, so you can immediately see exactly what changed. As the AI writes to a file, the edits appear character by character in real time, like a typewriter. A built-in terminal panel streams command output directly into the conversation, so you can watch a program run without switching windows. Several conversation-flow features were also added. You can retract a message you sent, which lets you undo a mistaken instruction and adjust it. You can also add a new instruction while the AI is still typing its response, rather than waiting for it to finish. The interruption handling was improved so that stopping the AI mid-reply does not corrupt the conversation or lose context. The memory system was redesigned to show each saved memory item as a separate entry and let you jump directly to the conversation turn where a memory was created. System prompts and tool descriptions are fully exposed and editable, so you can change how the AI behaves without any hidden instructions. A desktop companion feature adds a small on-screen figure you can query without opening the main window. Installation on Windows uses a standard installer. Running from source requires Node.js 22 or later and npm 10 or later. The project is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
I want HanakoPro to refactor a Python file on my computer. How do I ask it to make the changes, and how does the inline diff view show me what changed?
Prompt 2
How do I use HanakoPro's built-in terminal panel to run a test suite and have the output appear inside the chat window?
Prompt 3
I sent a wrong instruction to HanakoPro and it started doing the wrong thing. How do I use the message retract feature to undo it and try again?
Prompt 4
How do I edit HanakoPro's system prompt to change the AI's default personality and coding style preferences?
Prompt 5
How does HanakoPro's memory system work? How do I see all saved memory items and jump back to the conversation turn where a memory was created?
Open on GitHub → Explain another repo

← zs520l on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.