Development
Plugin
cc-haha
Claude Code Haha is a desktop Claude Code workspace for macOS, Windows, and Linux: multi-session workspaces, global search, branch / Worktree launch, diff review, built-in browser preview, GUI permission approval, any model — Claude, ChatGPT, Grok, presets,
Plugin Signal72/100Solid
maintained100
capable29
documented75
adopted88
Install
$ npx -y skills add NanmiCoder/cc-haha --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
14,011
Stars
8,530
Forks
Active
Maintenance
TypeScript
Language
MIT
License
10h ago
Last commit
4mo ago
Created
Repo: NanmiCoder/cc-haha
What's inside
Skills
3/claude-api<!-- @generated stub from scan-missing-imports --> stub/imagegenGenerate original images, artwork, product visuals, diagrams, or other raster assets with the desktop's configured image provider. Use whenever the user asks to create or generate an image./verifyVerify a code change does what it should by running the app.
Badges
8
README
1Claude Code Haha
English · 简体中文
Claude Code Haha is a desktop Claude Code workspace for macOS, Windows, and Linux: multi-session workspaces, global search, branch / Worktree launch, diff review, built-in browser preview, GUI permission approval, any model — Claude, ChatGPT, Grok, presets, or local endpoints — image generation, visual MCP & SubAgent managers, model trace, Computer Use, skill marketplace, colour themes, desktop pets, H5 remote access, IM integration, and scheduled tasks, all in one app.
Desktop Preview
Sponsorship & Partnership
This project is maintained in the author's spare time. Corporate or individual sponsorships are welcome to support ongoing development. Custom features, integrations, and business partnerships are also open for discussion.
📧 Contact: relakkes@gmail.com
Install the Desktop App
- Download the macOS / Windows / Linux desktop installer from Releases.
- On first launch, configure your model provider, API key, and default model in Settings.
- Public macOS releases require signing and notarization. Draft or unsigned temporary builds may still need one-time manual approval. Unsigned Windows installers may show SmartScreen; click "More info" -> "Run anyway". See the desktop installation guide.
Release trust and privacy: Code signing policy · Privacy and network access
Run the CLI from Source
For users who want to debug the underlying CLI, server, or local development flow:
bun install
cp .env.example .env
./bin/claude-haha
See environment variables and CLI setup for more configuration options.
Desktop Highlights
- Multi-session workspace: tabs, project switching, terminal entry, and session history in one place, with a resizable sidebar.
- Global search: press Cmd+K to search across every session and jump to the match.
- Branch / Worktree launch: choose a repository branch and decide whether to use the current working tree or an isolated Worktree.
- Review edits file by file: the workspace lists this turn's changes; open any file for a syntax-highlighted diff, or undo the whole turn.
- Built-in browser preview: the page your agent just edited renders right inside the app, cookies and login state included.
- Five permission modes: from "ask every time" to "skip permissions" — risky commands, tool calls, and follow-up questions are all approved in the GUI.
- Bring your own model: sign in to Claude, ChatGPT, or Grok; use presets for DeepSeek, Kimi, Zhipu GLM and others; or point it at LM Studio and Ollama running locally.
- Image generation: generate and edit images right in the chat — sign in with ChatGPT or Grok for instant use, or plug in any OpenAI-compatible Images API.
- Visual MCP manager: add and edit MCP servers in a GUI — STDIO / Streamable HTTP / SSE, with project, shared, or global scope.
- Six colour themes: white, paper, warm classic, celadon, ink night, and ink blue — optionally following your system's light/dark setting.
- Skill marketplace: discover, preview, and install third-party skills from ClawHub / SkillHub, with source and safety status shown up front.
- Session activity panel: track task progress, background tasks, SubAgents, and sources in one side panel.
- Visual SubAgent manager: create and tune SubAgents in a GUI — model, tools, and permission mode.
- Model trace: every model request is logged locally with status and timing — search and filter to diagnose stuck or failed calls.
- Computer Use: let the agent take screenshots, click, type, and control desktop apps after authorization.
- Desktop pets: Dada, Huhu, Bubu, and Huihui change what they do with the task at hand — or raise one of your own (off by default).
- H5 remote access: scan a QR code to continue the session in your phone browser; locking the screen won't kill a running task.
- IM integration: chat, switch projects, and approve actions through Telegram / Feishu / WeChat / DingTalk / WhatsApp.
- Scheduled tasks and usage stats: run planned tasks in their own sessions and track local token usage trends.
More Documentation
Full documentation site: https://cchaha.ai
| Section | Documents |
|---|---|
| Getting started | What this is · Download and install · Connect a model provider · Your first session · Troubleshooting |
| Desktop features | Feature overview · Computer Use · Desktop pets · Phone H5 and IM relay |
| IM integrations | Overview and pairing · Feishu · Telegram · WeChat · DingTalk · WhatsApp |
| CLI | Install and run · Command reference · Environment variables |
| Internals | Desktop architecture · Multi-agent system · Skills system · Memory system · Computer Use architecture · Local server and API · Channel system · Project structure · Contributing and quality gates |
☕ Buy Me a Coffee
If this project helps you, consider buying me a coffee — every bit of support keeps this project going ❤️
User Group
Scan the QR code below to join the cc-haha user group on Feishu (Lark) — the conversation there is mostly in Chinese. For questions and bug reports in English, Issues is the better place.
Tech Stack
| Category | Technology |
|---|---|
| Language | TypeScript |
| Desktop app | Electron |
| Desktop UI | React + Vite |
| Local runtime | Bun |
| Terminal UI | React + Ink |
| CLI parsing | Commander.js |
| API | Anthropic SDK |
| Protocols | MCP, LSP |
Acknowledgements
Thanks to the following open-source projects and community practices for reference and inspiration:
- React: frontend engineering and component-based UI ecosystem.
- Electron: cross-platform desktop app capabilities and engineering practices.
- cc-switch: reference for model provider configuration.
- LINUX DO: a new ideal developer community.
⭐ Star History
If this project helps you, please support it with a ⭐ Star so more people can discover Claude Code Haha.
File tree
1741NanmiCoder/cc-hahaView on GitHub
.env.example
.github/
AGENTS.md
CODEOWNERS
copilot-instructions.md
FUNDING.yml
ISSUE_TEMPLATE/
bug_report.md
config.yml
question.md
pull_request_template.md
workflows/
build-desktop-dev.yml
deploy-docs.yml
nightly-quality.yml
pr-quality.yml
pr-triage.yml
release-desktop.yml
.gitignore
adapters/
AGENTS.md
bun.lock
common/
__tests__/
adapter-client.test.ts
chat-queue.test.ts
config.test.ts
format.test.ts
http-client.test.ts
message-buffer.test.ts
message-dedup.test.ts
pairing.test.ts
permission.test.ts
session-recovery.test.ts
session-store.test.ts
ws-bridge.test.ts
adapter-client.ts
attachment/
__tests__/
attachment-limits.test.ts
attachment-store.test.ts
image-block-watcher.test.ts
outbound-image.test.ts
safe-remote-image.test.ts
attachment-limits.ts
attachment-store.ts
attachment-types.ts
image-block-watcher.ts
outbound-image.ts
safe-remote-image.ts
chat-queue.ts
config.ts
format.ts
http-client.ts
message-buffer.ts
message-dedup.ts
pairing.ts
permission.ts
session-recovery.ts
session-store.ts
ws-bridge.ts
dingtalk/
__tests__/
ai-card.test.ts
helpers.test.ts
permission-card.test.ts
stream-state.test.ts
ai-card.ts
helpers.ts
index.ts
media.ts
permission-card.ts
stream-state.ts
feishu/
__tests__/
card-errors.test.ts
cardkit.test.ts
extract-payload.test.ts
feishu.test.ts
flush-controller.test.ts
markdown-style.test.ts
media.test.ts
streaming-card.test.ts
card-errors.ts
cardkit.ts
extract-payload.ts
flush-controller.ts
index.ts
markdown-style.ts
media.ts
path-safety.ts
streaming-card.ts
package.json
README.md
telegram/
__tests__/
commands.test.ts
media.test.ts
menu.test.ts
telegram.test.ts
commands.ts
format.ts
index.ts
media.ts
menu.ts
tsconfig.json
wechat/
__tests__/
protocol.test.ts
typing.test.ts
index.ts
media.ts
protocol.ts
typing.ts
whatsapp/
__tests__/
format.test.ts
protocol.test.ts
session.test.ts
format.ts
index.ts
media.ts
protocol.ts
session.ts
AGENTS.md
bin/
claude-haha
bun.lock
bunfig.toml
CONTRIBUTING.md
desktop/
AGENTS.md
build/
check-install-processes.ps1
entitlements.mac.inherit.plist
entitlements.mac.plist
installer.nsh
recover-legacy-install-data.ps1
bun.lock
bunfig.toml
docs/
component-library-plan.md
redesign-paper-ink-seal.md
electron/
ipc/
capabilities.test.ts
capabilities.ts
channels.ts
previewMessage.ts
main.security.test.ts
main.ts
pet-preload.ts
preload.ts
preview-preload.ts
services/
appIdentity.test.ts
appIdentity.ts
appMode.test.ts
appMode.ts
appModeLifecycle.test.ts
dialogs.test.ts
dialogs.ts
keychain.test.ts
keychain.ts
localePreference.test.ts
localePreference.ts
menu.test.ts
menu.ts
nativeAppearance.test.ts
nativeAppearance.ts
navigationGuards.test.ts
navigationGuards.ts
notifications.test.ts
notifications.ts
notificationSmoke.test.ts
notificationSmoke.ts
pets.test.ts
pets.ts
petWindow.test.ts
petWindow.ts
preview.test.ts
preview.ts
previewLifecycle.test.ts
previewLifecycle.ts
previewSession.ts
rendererEntry.test.ts
rendererEntry.ts
rendererLifecycle.test.ts
rendererLifecycle.ts
serverRuntime.test.ts
serverRuntime.ts
shell.test.ts
shell.ts
sidecarManager.test.ts
sidecarManager.ts
singleInstance.test.ts
singleInstance.ts
stdioGuards.test.ts
stdioGuards.ts
systemProxyBridge.test.ts
systemProxyBridge.ts
terminal.test.ts
terminal.ts
tray.test.ts
tray.ts
updater.test.ts
updater.ts
updateSmoke.test.ts
updateSmoke.ts
windows.test.ts
windows.ts
windowSmoke.test.ts
windowSmoke.ts
windowStartup.test.ts
windowStartup.ts
zoom.test.ts
zoom.ts
tsconfig.json
eslint.config.js
gallery.html
icon-assets.test.ts
index-html.test.ts
index.html
package.json
pnpm-lock.yaml
public/
app-icon.png
app-icon.svg
fonts/
inter-latin-ext.woff2
inter-latin.woff2
jetbrains-mono-latin-ext.woff2
jetbrains-mono-latin.woff2
manrope-latin-ext.woff2
manrope-latin.woff2
material-symbols-outlined.woff2
noto-serif-sc-latin-ext.woff2
noto-serif-sc-latin.woff2
icons/
bilibili.svg
douyin.svg
github.svg
xiaohongshu.svg
README.md
scripts/
assemble-generated-pet-atlas.py
assert-electron-output-idle.ts
build-linux.sh
build-macos-arm64.sh
build-pet-sheet-guide.py
build-preview-agent.ts
build-sidecars.test.ts
build-sidecars.ts
build-windows-x64.ps1
clean-dmg-builder-cache.sh
clean-electron-output.ts
dev-launcher.test.ts
e2e-context-usage-live-agent-browser.sh
e2e-deepseek-thinking-ui-agent-browser.sh
e2e-install-center-agent-browser.sh
e2e-parallel-providers-agent-browser.sh
e2e-rewind-agent-browser.sh
e2e-rewind-complex-agent-browser.sh
e2e-slash-plugin-agent-browser.sh
electron-dev.ts
electron-output-guard.test.ts
electron-output-guard.ts
install-macos-unsigned.sh
prepare-node-pty.ts
prepare-ripgrep.test.ts
prepare-ripgrep.ts
ripgrep-licenses/
COPYING
LICENSE-MIT
UNLICENSE
scan-missing-imports.ts
windows-installer-smoke.ps1
sidecars/
claude-sidecar.ts
launcherRouting.test.ts
launcherRouting.ts
src/
src-tauri/
app-icon-macos.svg
app-icon.png
app-icon.svg
build.rs
capabilities/
default.json
Cargo.lock
Cargo.toml
icons/
128x128.png
128x128@2x.png
256x256.png
32x32.png
512x512.png
64x64.png
android/
mipmap-anydpi-v26/
ic_launcher.xml
mipmap-hdpi/
ic_launcher_foreground.png
ic_launcher_round.png
ic_launcher.png
mipmap-mdpi/
ic_launcher_foreground.png
ic_launcher_round.png
ic_launcher.png
mipmap-xhdpi/
ic_launcher_foreground.png
ic_launcher_round.png
ic_launcher.png
mipmap-xxhdpi/
ic_launcher_foreground.png
ic_launcher_round.png
ic_launcher.png
mipmap-xxxhdpi/
ic_launcher_foreground.png
ic_launcher_round.png
ic_launcher.png
values/
ic_launcher_background.xml
icon.icns
icon.ico
icon.png
ios/
AppIcon-20x20@1x.png
AppIcon-20x20@2x-1.png
AppIcon-20x20@2x.png
AppIcon-20x20@3x.png
AppIcon-29x29@1x.png
AppIcon-29x29@2x-1.png
AppIcon-29x29@2x.png
AppIcon-29x29@3x.png
AppIcon-40x40@1x.png
AppIcon-40x40@2x-1.png
AppIcon-40x40@2x.png
AppIcon-40x40@3x.png
AppIcon-512@2x.png
AppIcon-60x60@2x.png
AppIcon-60x60@3x.png
AppIcon-76x76@1x.png
AppIcon-76x76@2x.png
AppIcon-83.5x83.5@2x.png
Square107x107Logo.png
Square142x142Logo.png
Square150x150Logo.png
Square284x284Logo.png
Square30x30Logo.png
Square310x310Logo.png
Square44x44Logo.png
Square71x71Logo.png
Square89x89Logo.png
StoreLogo.png
Info.plist
resources/
preview-agent.js
src/
lib.rs
macos_notifications.m
main.rs
webview_panel.rs
tauri-config.test.ts
tauri.conf.json
tauri.macos.conf.json
tauri.release-ci.json
tauri.windows.conf.json
windows-installer-hooks.nsh
__tests__/
agentsSettings.test.tsx
componentReachability.test.ts
contextUsageLifecycle.test.tsx
diagnosticsSettings.test.tsx
generalSettings.test.tsx
mcpSettings.test.tsx
mcpStoreKnownProjects.test.ts
memorySettings.test.tsx
mockPaths.test.ts
pages.test.tsx
petSettingsNavigation.test.tsx
pluginsSettings.test.tsx
skillsSettings.test.tsx
tauriCapabilities.test.ts
api/
activityStats.ts
adapters.ts
agents.test.ts
agents.ts
client.test.ts
client.ts
cliTasks.ts
computerUse.ts
desktopUiPreferences.test.ts
desktopUiPreferences.ts
diagnostics.ts
doctor.ts
filesystem.ts
h5Access.ts
hahaGrokOAuth.ts
... 1600 moreShowing a partial view of a very large repo.
FAQ
cc-haha is a Claude Code plugin with 3 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes claude-api, imagegen, verify. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is cc-haha?
- Claude Code Haha is a desktop Claude Code workspace for macOS, Windows, and Linux: multi-session workspaces, global search, branch / Worktree launch, diff review, built-in browser preview, GUI permission approval, any model — Claude, ChatGPT, Grok, presets,
- How do I install cc-haha?
- Run these in Claude Code: npx -y skills add NanmiCoder/cc-haha --agent claude-code. Then prompt normally.
- Does cc-haha auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is cc-haha free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.