PlugWiki
cunzhi logo

Cunzhi (寸止) MCP Server: Setup for Claude Code, Cursor and Other Apps

CommunityLocal
Getimhuso/cunzhi
Tools
3
0 read · 3 change
Works in
12
apps
Risk
Medium
can write
Auth
None
Version
0.4.0
last commit May 2026

Lets your assistant stop and ask you in a popup, instead of ending the chat early.

Cunzhi (寸止) is a small desktop program from the community developer imhuso. It gives your assistant a tool that opens a popup window with a message and options, so you can answer and keep going. Two more tools, project memory and code search, are off until you switch them on in its settings window. It runs on your computer with no account, and its README and settings are in Chinese.

Good for

  • People whose assistant keeps wrapping up before the job is done
  • Developers who want a place to review and answer in a window while the agent works
  • Users who want per-project rules saved as files in the repo

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install cunzhi MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the cunzhi MCP server to Claude Code. Run this command:

claude mcp add cunzhi -- 寸止

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Download 寸止 and 等一下 from the Releases page, or use Homebrew on macOS.

Read-only mode: No read-only option. Leave the memory and code search tools off in the settings window; they are off by default.

Install the program first. On macOS run brew tap imhuso/cunzhi && brew install cunzhi. On Windows and Linux, download the archive for your system from the Releases page, unzip it and add the folder to your PATH. The two programs, 寸止 and 等一下, must stay in the same folder. Run 等一下 once to open settings, copy the suggested prompt and add it to your assistant's rules. Setup instructions are in Chinese. The config shown is adapted from the README's Claude Desktop example; the project does not document this app.

Built from the package data we hold. Not yet tested by us.

Tools

  • Opens a popup so you can answer, pick an option or attach images

    Shows a window on your screen with the assistant's message. You can click a suggested option, type a reply or add images, and your answer goes back to the assistant. It is the tool that keeps a chat going instead of letting the assistant stop.

    Try: “Before you finish, ask me in a popup whether anything else needs changing.”

    Runs code · zhi

  • Saves and recalls project rules and preferences (off by default)

    Remembers a note for the current project, filed as a rule, a preference, a best practice or project context, or reads back what is already saved. Notes are stored as files in a .cunzhi-memory folder at the root of your git project. The project folder must be a git repository.

    Try: “Remember that this project uses pnpm and tabs, not npm and spaces.”

    Write · ji

  • Searches your codebase by meaning, using an outside index (off by default)

    Takes a plain-language question and finds related code in your project. To do it, it sends the project's code files in batches to the search service address you set in the settings, then asks that service for matches. A bundled index record is kept in a .acemcp folder in your home directory.

    Try: “Find where this project handles user login.”

    Write · sou

Read from the source code

Permissions

medium risk · 5 things to watch

Medium risk

By default only the popup tool is on, and it reads your reply from a window. If you enable code search, your project files go to the service address you set, so use one you trust and keep secrets out of the folder.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Code search uploads your project files

    If you turn on the sou tool, it sends your project's code files in batches to the service address you configure, with your token. It follows .gitignore and your exclude patterns, so check both first. github.com

  • Memory writes files inside your repo

    The ji tool creates a .cunzhi-memory folder at the git root and writes rule and preference notes there. Add it to .gitignore if you do not want it committed. github.com

  • Code search keeps an index record in your home folder

    The sou tool stores project data under .acemcp in your home directory. It only runs when the tool is enabled. github.com

  • Optional Telegram forwarding

    The settings include a Telegram bot option, off by default. If you turn it on, popup content goes through Telegram's servers. github.com

  • Opens a window and starts a helper program

    The popup tool launches the companion 等一下 program on your machine, so it needs a desktop session and both programs in one folder. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only switch. The memory and code search tools are off by default and can be left off in the settings window.
Talks toOnly if you turn on code search (the address you set) or Telegram forwarding
Sign-in and keysNo account or API key for the popup and memory tools. Code search needs a service address and token that you enter in the settings window.

Questions

Is Cunzhi official?

No. It is a community project by imhuso on GitHub, not made by Anthropic, Cursor or any assistant it works with.

Which of the three tools are on by default?

Only the popup tool. Project memory and code search are off until you turn them on in the settings window, which you open by running 等一下.

How do I stop the assistant from ending early?

Open the settings window, copy the suggested prompt from the reference prompt tab, and add it to your assistant's rules or instructions. The README says the assistant then calls the popup tool when it would normally stop.

Does code search send my code anywhere?

Yes, if you turn it on. It uploads your project's code files to the service address you enter in settings and queries that service for matches. The popup and memory tools do not need a network.

Do I need an API key or account?

Not for the popup or memory tools. Code search needs a service address and token, which you set in the settings window.

Which systems does it run on?

Linux (x86_64), macOS (Intel and Apple Silicon) and Windows (x86_64). It needs a desktop session because it opens a popup window.

Is the documentation in English?

No. The README, install guide and settings are in Chinese. The install box above has the commands and config you need.

Is it still maintained?

Its latest release is v0.4.0 from November 2025, and the most recent commit (adding the MIT license file) is from May 2026.

What license is it under?

MIT, but with a caveat for the release you download. The README of v0.4.0 (November 2025) says MIT, yet that tag has no LICENSE file. An MIT LICENSE file was added to the repository in May 2026, after v0.4.0, so the current main branch carries it and the release archives do not.

Information

updated Nov 2, 2026

Publisher
Community
Transport
stdio
Auth
None
Version
0.4.0
License
MIT
Last commit
May 12, 2026
Open issues
0

GitHubChangelog

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 7
  1. cunzhi README · github.com
  2. cunzhi INSTALL.md · github.com
  3. cunzhi settings source · github.com
  4. cunzhi MCP server source, release v0.4.0 · github.com
  5. cunzhi code search tool source · github.com
  6. cunzhi memory manager source · github.com
  7. chore: add MIT LICENSE (#59) · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.