What Is Nezha?
Nezha is an open-source agent-first desktop application built specifically for multi-project parallel Vibe Coding. It natively integrates Claude Code and Codex, combining multi-project management, task lifecycle tracking, a native terminal experience, session replay, code browsing, and a complete Git workflow in one interface.
The insight behind it: traditional IDEs and VS Code are fundamentally developer-centric. In the classical coding era, plugin systems, refactoring, and variable suggestions all served human typing efficiency. Now that AI writes an ever-larger share of the code, writing code has genuinely started to run in parallel — something unimaginable before. But human attention is finite, and quickly tracking tasks across multiple projects is exactly the problem Nezha set out to solve.
1. Multi-Project Workspace: Switch Between Vibe Coding Tasks in One Click
Nezha’s signature feature is managing multiple projects and multiple vibe-coding tasks in a single interface: fast switching through a left-hand project navigator that jumps between repositories seamlessly while terminals stay alive in the background; real-time sync of task status across projects, with pending-confirmation sessions lighting up yellow on their project as an explicit reminder; and multi-agent support running several Claude Code or Codex instances simultaneously, each managing its own tasks independently. One click moves you between projects and tasks — goodbye to the terminal-editor-Git-tool shuffle.
2. Real-Time Terminal: The Native Claude Code / Codex Experience
Nezha embeds a full PTY terminal built on xterm.js, integrating Claude Code and Codex directly: millisecond response with a desktop-app-grade terminal feel, virtual terminals running the native CLI agents, and output plus interaction quality that approximates your local terminal.
3. Session Auto-Discovery and Visual Replay
Nezha automatically identifies and associates Claude Code / Codex sessions, alerting you the moment a task needs manual confirmation. Visualized session history shows the details of every exchange with your agents right on the page, and any historical task can be replayed and resumed at will — nothing gets lost in scrollback.
4. Full Task Lifecycle Management
From creation to completion, Nezha tracks every state change: transparent status — waiting → running → needs input → done; visualized session display and recovery — finished tasks automatically surface their session records, resumable anytime; personalized input — the task box supports @ operations, image pasting, and pre-prompts; and starred favorites to pin important tasks for quick access.
5. A Lightweight Code Viewer: Goodbye IDE Bloat
Nezha bundles a file browser and a Shiki-powered code viewer, and the whole installer is just 7MB: a clean file tree with fast expand/collapse; live Git status annotations so changes are visible at a glance; professional syntax highlighting via Shiki/CodeMirror across 100+ languages; direct file editing saved to disk; and a built-in Markdown editor with live preview. For light needs, you complete the whole loop — dispatch tasks, review code, commit — without ever opening a heavyweight IDE, and without interrupting work running in your other projects.
6. Native Git Integration With AI Commit Messages
The full change loop happens without leaving Nezha: a Git diff view for staged and unstaged changes with syntax highlighting; Git logs for browsing history and the detailed diff of any commit; AI-generated commit messages that match your project’s conventions; and branch management covering creation, switching, merging, deletion, and history.
7. Usage Analytics: Quantify Agent Efficiency and Cost
Weekly dashboards track token consumption and tool-call counts with visualizations that help you understand agent productivity, follow your AI coding spend, and tune how you allocate tasks across agents.
8. A Polished UI
It’s a programming tool, but aesthetics didn’t get sacrificed: a carefully tuned visual style balancing information density and readability, built-in light and dark themes for long sessions, and pages designed to look good morning and night.
Installation and Setup
Prerequisite: install Claude Code or Codex first. On macOS, the first launch may show “Nezha is damaged and can’t be opened” because the package is unsigned — clear it with:
xattr -rd com.apple.quarantine /Applications/nezha.appThen: download the latest release from GitHub Releases, install and run Nezha, add your project folders, start a Claude Code or Codex task, and begin your vibe-coding run.
The Tech Stack
Nezha stands on excellent open-source shoulders: Tauri for smaller, faster, safer desktop apps; React for the interface; xterm.js for the terminal component; and Shiki/CodeMirror for syntax highlighting.
The Roadmap
| Feature | Status |
|---|---|
| Windows support | Planned |
| Linux support | Planned |
| Visual agent configuration management | Planned |
| Multi-account management | Planned |
| Code review view | Planned |
| Git worktree support | Planned |
Who It’s For
- Multi-project developers juggling several repositories who need fast context switches
- AI coding enthusiasts running Claude Code or Codex heavily who want more vibe-coding throughput
- Lightweight devotees who’d rather never open a bulky IDE and just focus on code plus conversation
- Git power users who want editing, review, and commit in one closed loop
The Bottom Line
Nezha is a genuinely agent-first vibe-coding tool. It doesn’t try to replace your IDE — it attacks the core pain of the AI coding era: how to stay focused and efficient while many tasks run in parallel. The 7MB footprint, native terminal feel, multi-project workspace, complete Git integration, and polished UI make it an indispensable member of the AI coding toolbox. If you’re looking for a tool that actually raises your vibe-coding efficiency, give Nezha a spin. Official site: nezha.hanshutx.com · GitHub: github.com/hanshuaikang/nezha · Downloads: GitHub Releases. Currently macOS only; Windows and Linux are in development.
