⚠️ Note — source code not yet released. This repository currently provides the project introduction, changelog, and pre-built installers only. The full source code is not published yet. To use JClaude, download the installer from the Releases page. Source code may be published at a later date.
JClaude is a desktop + web client modeled on the official Claude desktop app. Its main goal is to make Claude Code usable without a terminal — install and go.
- Bundled Claude Code — the installer ships its own copy of Claude Code, so you don't need to install Node, the CLI, or any environment yourself. The Code workspace uses the bundled copy by default.
- Chat workspace — a faithful clone of the Claude chat experience: streaming, Markdown / code blocks, thinking blocks, adaptive thinking, Projects, rename / archive / pin conversations.
- Code workspace — Claude Code wrapped in a GUI: real terminal, file browser, web preview, diff / plan / task panels, usage stats.
- Experts & Skills — built-in expert roles (with avatars / descriptions /
system prompts), plus auto-discovery and in-app management of local
SKILL.mdskills from Claude / Codex. - Themes & i18n — light / dark / auto plus two kid themes (boy / girl); Chinese and English.
| Module | Description |
|---|---|
| 🤖 Bundled Claude Code | Install and go; switch between bundled / system-installed / custom path in Settings; version-locked, auto-update off by default, uses an isolated config dir so your system install is untouched |
| 💬 Chat | Streaming, Markdown rendering, thinking blocks, adaptive thinking, 6 permission modes, conversation / project management, resume |
| 🛠️ Code workspace | Built-in terminal (xterm.js), file tree, web preview, diff / plan / task panels, session grouping & filtering, real usage stats (overview + per-model) |
| 🧑🏫 Experts & Skills | 17 built-in expert roles (coding / work / life / study / finance…); auto-scan & manage SKILL.md under ~/.claude, ~/.codex, ~/.jclaude |
| 🎨 Themes | 5 options: light / auto / dark / boy (electric blue) / girl (cherry pink) |
| 🌐 i18n | Chinese / English, full coverage (buttons, tooltips, menus, placeholders) |
| 🖥️ System integration | Custom title bar, system tray (click to toggle + right-click quick prompt), single-instance, main / worktree tags reflect real git state |
| 📦 Packaging | NSIS installer (recommended) + MSI for enterprise; full Release Runbook in AGENTS.md |
JClaude/
├── desktop/ # Tauri v2 desktop app (the build target)
│ ├── src/ # Frontend: vanilla JS (main.js + styles.css + index.html)
│ ├── src-tauri/ # Rust backend (streaming chat, terminal, skill scan, single-instance…)
│ │ ├── Cargo.toml
│ │ ├── tauri.conf.json
│ │ └── src/lib.rs
│ └── package.json
├── web/ # React + Vite web app
├── DOCS/ # Tech changelogs & reference docs (by date)
├── release/ # Release archive (per-version installers + cross-version notes)
├── AGENTS.md # Agent collaboration spec + Release Runbook
├── CLAUDE.md # Pointer to AGENTS.md
└── changelog.txt # Detailed changelog (Added / Changed / Fixed)
- Node.js ≥ 20.19 (also supports ≥ 22.12)
- Rust stable toolchain (desktop pins
1.91.1, seerust-toolchain.toml) - Platform dependencies required by Tauri v2
On macOS, install the Xcode command line tools:
xcode-select --installOn Linux / Windows, follow the Tauri v2 system dependency guidance for the target platform.
cd web
npm install
npm run dev # dev server
npm run build # production buildcd desktop
npm install
npm run dev # dev (tauri dev)
npm run build # release build (runs cargo fmt check, then tauri build)Before building, stop any running
tauri dev/ installed JClaude, otherwise thetarget/dir is locked and the build fails.
Desktop build artifacts:
| Type | Path |
|---|---|
| NSIS installer (recommended) | desktop/src-tauri/target/release/bundle/nsis/JClaude_X.Y.Z_x64-setup.exe |
| MSI (enterprise deployment) | desktop/src-tauri/target/release/bundle/msi/JClaude_X.Y.Z_x64_en-US.msi |
macOS cross-arch builds: npm run build:mac / build:mac:intel / build:mac:arm / build:mac:universal.
- Pre-built installers are published on the Releases page (attached to each version tag).
- Full version history: CHANGELOG.md.
The standard release runbook (bump version files → pre-build prep → build → archive → tag) is documented in the internal
AGENTS.md. Source code is not published yet, so this file is referenced by name only for now.
No open-source license has been granted yet (see LICENSE.md). Do not
redistribute or use commercially without permission.
Made by @JarvisPMS · Issues welcome