Nezha

Nezha is a lightweight desktop IDE designed for the AI Agent programming era. Built with Tauri v2 and React 19, it has an installer size of only about 7MB and supports macOS, Windows, and Linux.

Its core advantage lies in multi-project workspace management, allowing developers to run multiple Claude Code and Codex agent instances simultaneously. Terminals run continuously in the background, with task statuses synced in real-time via indicators. It provides visual tracking of the full task lifecycle—from creation and execution to pending input and completion—along with session replay and interruption recovery to ensure workflow continuity.

It features a built-in code and Markdown editor based on CodeMirror and Shiki, offering professional multi-language syntax highlighting and .gitignore filtering. Deep native Git integration provides unified/split Diff views, log browsing, branch management, and AI-assisted generation of standard-compliant Commit Messages. The smart session management automatically associates Agent sessions and alerts users when manual intervention is needed. Additionally, a built-in dashboard for weekly Token consumption and tool call statistics helps accurately control AI coding costs. The interface supports light/dark theme switching and internationalization (i18n).

Architecture Highlights#

• Desktop Framework: Tauri v2 (Rust backend + Web frontend) for minimal installer size
• Terminal Emulation: xterm.js v6 + WebGL addon with advanced interactions like pause-on-select
• IPC Communication: per-task Channel architecture (introduced in v0.3.3) with PTY stream batching optimizations
• Safe Rendering: Markdown rendered with marked + DOMPurify for XSS protection

Installation#

Prerequisites: Claude Code or Codex CLI must be installed locally.

Binary Installation: Download platform-specific installers from GitHub Releases (macOS .dmg, Windows .exe/.msi, Linux .deb/.rpm). On macOS, if a security prompt appears:

xattr -rd com.apple.quarantine /Applications/nezha.app

Build from Source:

pnpm install
pnpm tauri dev    # Development mode
pnpm build        # Build frontend
pnpm tauri        # Tauri commands

Unconfirmed Information#

• Windows/Linux stability: README primarily describes macOS; cross-platform experience awaits community feedback
• Integration method: Likely uses PTY pseudo-terminal to invoke CLIs directly, but not explicitly documented
• Codex RPC Client protocol details remain unconfirmed
• Linux support maturity: Builds added in v0.3.2, but Roadmap still lists it as Planned, suggesting incomplete functionality