Agent workspace · hanshuaikang

Nezha

Small desktop app for running several Claude Code and Codex sessions across projects, with a built-in terminal, session replay, git and worktree support, a light code editor and local skill management.

Reviewed by the Termdex team · facts checked 2026-10-28 against 5 vendor sources · how we check

Official site

Screenshot of the Nezha AI agent workspace interface — A screenshot of Nezha from the project's README. Image: hanshuaikang (GitHub README).

Screenshot of the Nezha AI agent workspace interface, view 2 — A screenshot of Nezha from the project's README. Image: hanshuaikang (GitHub README).

Nezha review

Nezha is a small free desktop app for running several Claude Code and Codex sessions across different projects. It adds a built-in terminal, session history, git and a light editor. We read the vendor's site and GitHub pages in October 2026. We did not run an independent test.

Who it is for

Developers who already use Claude Code or Codex locally, work on several repositories, and want one free app to keep track of the sessions.

What stands out

A project sidebar lets you jump between repositories and their agent sessions. The README says the app raises a system notification and a badge when an agent needs input. Finished sessions are shown as a readable transcript that you can resume.

Git is built in, including AI-written commit messages and a review view. Git worktrees are supported, and a code and Markdown editor is included. Skills are managed centrally through symlinks.

Installers on the v0.5.0 release page (17 September 2026) cover macOS on Apple Silicon and Intel, Windows (x64 and arm64), and Linux as deb and rpm. The code is under GPL-3.0, and we read the licence file. It is a copyleft licence, which matters if you plan to build on it.

Where it falls short

Only Claude Code and Codex are named as agents, and both must be installed first.
The macOS build is unsigned. The README tells you to run a terminal command to clear the quarantine flag.
It is version 0.5.0, maintained by one person, with no release since 17 September.
The README does not describe SSH or remote machines, MCP, or a mobile app. We treat those as not verified.
The vendor site rendered no readable text for us, so we relied on the README and releases.

Price

No pricing was seen. The app and source are free under GPL-3.0 (seen 28 October 2026). You supply your own Claude Code or Codex access.

Verdict

Choose it if you run Claude Code or Codex on your own machine across several projects and want a small free tracker with git built in. Look elsewhere if you need other agent CLIs, remote SSH sessions or a phone companion.

Facts: platforms, price and licence

platforms: macOSWindowsLinuxInstallers on GitHub release v0.5.0: .dmg (Apple Silicon and Intel), .exe/.msi (x64 and arm64), .deb and .rpm. README says the macOS build is unsigned and needs an xattr command to open. Official site is JavaScript-only and showed no readable text; facts come from README and releases.
price: FreeFree; no paid tier or pricing page seen. GPL-3.0 licence file in repo. README says Claude Code and/or Codex must already be installed. Seen 2026-10-28.
source: Open sourceLicence: GPL-3.0 (full GNU GPL v3 text in LICENSE, read 2026-10-28)
github: hanshuaikang/nezha 1.9k stars, seen 2026-10-28

Nezha features

✓ yes AI agents
✓ yes Multi-agent
✓ yes Git worktrees
? not verified MCP
? not verified Phone control
? not verified Mobile app
? not verified SSH
? not verified SFTP
? not verified Tabs
? not verified Split panes
? not verified Cloud sync
? not verified Team sharing

✓ documented · – absent or not in its feature list · ? not verified

Nezha strengths

GPL-3.0 licensed with desktop installers for macOS, Windows and Linux on GitHub releases
Tracks many Claude Code and Codex sessions across several projects, with desktop notifications when an agent needs input
Finished sessions can be viewed as a transcript and resumed
Built-in git view with AI-written commit messages, worktree support, a code and Markdown editor, and skill management through symlinks

Nezha weak points

Supports only Claude Code and Codex as agents; both must be installed separately
macOS installer is unsigned, so first launch needs a terminal command to clear the quarantine flag
Version 0.5.0 and a single-maintainer project; no release since 2026-09-17
No SSH or remote-machine, MCP or mobile features are described in the README

Who Nezha is for

best for: Developers who use Claude Code or Codex locally on several projects and want one free, small desktop app to track sessions and git state.
look elsewhere if: Users who need remote SSH sessions, other agent CLIs, a mobile companion or an app with a commercial support offer.

Lists that include Nezha

Sources and what we could not verify

Checked 2026-10-28. Prices and features change; the vendor's page is the authority.

github.com/hanshuaikang/nezha/blob/main/README_EN.md — features, Claude Code/Codex requirement, unsigned macOS note, worktree, notifications, session view
api.github.com/repos/hanshuaikang/nezha — GPL-3.0 licence id, 1905 stars, last push 2026-09-17, not archived, homepage nezha.hanshutx.com
github.com/hanshuaikang/nezha/blob/main/LICENSE — full GNU GPL v3 text
api.github.com/repos/hanshuaikang/nezha/releases — v0.5.0 on 2026-09-17; asset names show macOS, Windows, Linux installers
nezha.hanshutx.com — site reachable (HTTP 200) but JavaScript-only; no text read

Not verified

official site text not readable (JS-only); no pricing page seen, 'free' rests on README plus GPL licence
ssh, sftp, tabs, split_panes, port_forwarding, jump_host, x11, serial, telnet, mosh, cloud_sync, team_sharing, scripting_or_api, mcp, phone_remote, mobile_app: not stated in README
README says it is a lightweight 'IDE'; terminal exists (xterm.js) but multi-tab/split behaviour not documented
7 MB installer size is a vendor claim, not checked
Windows and Linux support inferred from release assets, not from a README statement