A native macOS and Linux toolkit for a cleaner workspace and an environment you can verify.
Claude cleanup · Browser fingerprints · System settings · Network Skill
Features · Installation · Updates · Quick start · Architecture · Development · Contributing
CCBaga brings local maintenance and environment setup into one focused desktop workflow. Inspect Claude data before removing it, rotate your companion browser's fingerprint and restart it, align system settings with a selected region, and compare real browser readings with the machine and network exit.
Two applications work together: CCBaga-A owns native operations; CCBaga-B runs an isolated Fingerprint Chromium profile. Browser measurements return to the cleaner through a local session. Changing a setting and verifying its effect are separate steps.
| Local Claude cleanup Review caches, account traces, sessions, configuration remnants and existing backups. Select exactly what to remove. |
Fingerprint & restart Generate a fresh seed, apply the selected region's language and timezone, then restart the companion browser. |
Real environment checks Compare browser and machine readings with the actual network exit. Passing measured checks produces a green page and a large checkmark. |
| Native system settings Apply timezone, preferred language and region settings. Open desktop controls for location and permissions; see Linux feature limits. |
AI-guided network setup Three simple steps, a coding-agent selector and a copyable Skill installation prompt. Give the AI your files and connection details; it handles the commands. |
Claude Code CLI tools Detect the installation method and version. Uninstall or reinstall through native, npm or Homebrew workflows. |
One region selector. Four everyday actions. Easy setup puts browser cache cleanup, fingerprint rotation, timezone/language reset and Claude cleanup on the same page. The sidebar keeps advanced controls in Network, Claude cleanup, Browser and Computer.
The interface supports English and Chinese, with shared YAML catalogs. Switching the interface language does not change the computer or browser language.
Platforms: macOS 12 or later on Apple Silicon; Linux x86_64 with GTK 3 and WebKitGTK 4.1. Windows, Intel macOS and Linux ARM64 are not supported.
Linux x86_64 packages include DEB, RPM, AppImage and Arch/pacman formats, with the companion browser included. See Linux setup for installation and platform limits. Official versions are published exclusively by the project owner, liseami.
Download the official installer from GitHub Releases. The distribution package is named CCBaga-<version>-macos-arm64.dmg. It contains both applications:
| Application | Installed bundle | Role |
|---|---|---|
| CCBaga-A | CCBaga-A.app |
Cleanup, system settings and environment verification |
| CCBaga-B | CCBaga-B.app |
Companion browser with a dedicated profile |
Download one DMG; it contains both applications. There is no separate browser download. The installer uses the same pixel-art style as this README.
- Open the disk image and drag both applications into Applications.
- Launch CCBaga-A. It starts the companion browser automatically.
- Choose English at the bottom of the sidebar if needed.
Source builds are available through the development guide.
Use Check for updates at the bottom of CCBaga-A’s sidebar. Startup checks quietly; installation only starts when you choose Update and restart. Downloads show actual progress and are verified before installation. Failed downloads can be retried; a failed restart does not download the update again.
In-app updates replace CCBaga-A. To update both A and B, download the latest DMG and drag both apps into Applications.
Open Easy setup, select a country or region, then choose an action. Browser fingerprint rotation closes and restarts CCBaga-B, so save unfinished browser work first. Selecting a region changes language, timezone and regional settings; it does not change your public IP.
Open Claude cleanup to scan and review local data. Use cache-only cleanup for regenerable files, login reset for account traces, or select a broader scope explicitly. A folder can also be dropped into the app for a scoped scan.
If Claude is running, the confirmation flow can stop all recognized Claude processes and rescan. The latest scan must be reviewed before deletion. CLI uninstall and reinstall are separate operations and preserve settings, skills, sessions and project files.
Warning
Confirmed cleanup permanently deletes the selected files, including selected existing backups. It does not use Trash, create recovery copies or provide undo. Stopping Claude processes can interrupt unsaved work.
Open Browser or the companion browser's local test page to measure the actual environment. Checks cover the network exit, country, timezone, language, platform, CPU count, engine version and location settings.
The success page appears only when the measured checks match, the report reaches the cleaner and no measurement error remains. DNS and WebRTC leak checks are not independently verified. A green result describes the measured checks, not a guarantee of anonymity or account acceptance.
Open Network for three steps: Get VPS → Get residential proxy → Install Skill. Select General, Codex, Cursor, OpenCode or Copilot, then copy the installation prompt into your local coding agent. The prompt follows the app's English/Chinese setting.
The Network Skill installs separately from the apps. Give the AI your VPS address, the three matching PEM/PPK/PUB files or downloaded key bundle, and your residential SOCKS5 connection details. It handles file paths, private configuration, commands and checks; you do not need to open a terminal or edit JSON. Missing resources are purchased by you with the AI's guidance. Remote setup runs only after approval of the actual server changes.
The Skill supports authorized Debian 12/13 servers using root key login on port 22. It checks the SSH identity and fixed SOCKS5 exit, configures Xray/Reality and delivers a private local import file after server self-checks pass. Client setup uses TUN ON, System Proxy OFF and an empty explicit browser proxy; actual TUN/browser verification remains a separate step. The subscription URL uses HTTP and contains credentials; prefer the file retrieved over SSH.
Provider buttons link to DMIT and Webshare. Network setup is optional; local cleanup does not require a VPS or a proxy subscription. The app does not collect SSH keys or proxy credentials and does not deploy to servers.
The UI owns inputs and presentation. Rust owns validation, task locks, process identity checks and execution. Small Objective-C bridges call macOS APIs; a Rust Linux boundary uses procfs and desktop/session utilities. The browser test page has no Tauri command access; it exchanges context and measurements through a random-token loopback session.
| Layer | Technology | Responsibility |
|---|---|---|
| Desktop host | Rust · Tauri 2 | Native commands, transactions, progress and lifecycle |
| Interface | React 19 · TypeScript · Cromma UI | Forms, previews and execution results |
| Platform bridges | AppKit · Security · CoreLocation · Linux Rust | Platform permissions and system integration |
| Companion browser | Fingerprint Chromium | Dedicated profile and real browser measurements |
| Separate Network Skill | Python standard library · OpenSSH · Bash · Xray | AI-managed private configuration, approved remote setup and server/client verification |
| Localization | YAML · Vite | Build-time English/Chinese catalogs |
Repository map
assets/ Compressed brand logos and pixel-art DMG background
src/ Desktop UI, browser test page and localization
src-tauri/src/ Rust commands and transaction boundaries
src-tauri/native/ Small macOS API bridges
browser-runtime/ Engine metadata, launcher, entitlements and licenses
scripts/ Icons, local builds and installation helpers
skills/ Installable AI Network Skill and its execution scripts
packaging/arch/ Native Arch Linux PKGBUILD and desktop entry
docs/ README artwork and Linux development guide
vendor/cromma-ui/ Vendored interface components
The large browser application and archive are generated/runtime inputs, excluded from Git. CLAUDE.md files map module boundaries; source headers describe inputs, outputs and responsibilities.
On Linux, follow Linux setup. On macOS, use an Apple Silicon Mac with Xcode Command Line Tools, stable Rust and Bun. Follow Tauri's macOS prerequisites for the native toolchain.
The browser engine is an external build input. python3 scripts/fetch-browser.py downloads the pinned macOS arm64 Fingerprint Chromium 148.0.7778.215 engine from the upstream project, verifies its SHA-256 and preserves its bundle structure and notices. Browser runtime binaries are not included in the source repository.
From your checkout:
bun install --frozen-lockfile
python3 scripts/fetch-browser.py
sh scripts/make-icons.sh
sh scripts/package-browser.sh
bun run tauri devLocal builds are for development and testing; they are not official project downloads.
bun run dev:installThis builds a debug app with the embedded UI, uses local ad-hoc signatures and installs/starts both apps. It does not use Apple credentials or create an installer. It preserves profiles and settings. The development installer accepts only locally built debug apps; downloaded installers still require the normal signature and Gatekeeper checks.
MACOSX_DEPLOYMENT_TARGET=12.0 \
bun run tauri build --bundles app --features custom-protocolThe cleaner bundle is written to src-tauri/target/release/bundle/macos/CCBaga-A.app. The companion bundle remains at browser-runtime/Browser.app until copied to Applications as CCBaga-B.app.
Production builds require custom-protocol to load the embedded UI. Compilation without it fails explicitly, preventing an installed app from depending on the development server.
bun run build
bun test
MACOSX_DEPLOYMENT_TARGET=12.0 \
cargo test --manifest-path src-tauri/Cargo.toml
python3 scripts/test-sign-browser.py
python3 skills/ccbaga-network/scripts/test_network.py
bash -n skills/ccbaga-network/scripts/setup-vps.shAutomated tests exercise disposable fixtures and local test servers. They do not deploy a real VPS, delete your Claude account data or perform administrator-authorized system changes. Real SSH connectivity, client-side TUN routing and permission-dependent operations require validation in the target environment.
- Cleanup is local. It targets recognized Claude data; project source, skills, plugins, hooks, commands and MCP settings are preserved. Cloud-side account records are outside its scope.
- Secrets stay out of UI logs. The apps have no SSH key picker or server deployment command. Keychain cleanup reads item attributes, not password contents. The separate Skill uses private local files and temporary
0600PEM copies; data supplied to your coding agent is subject to that agent provider’s handling. - Network checks make real requests. Exit detection uses
ipwho.iswithipapi.coas a fallback on the same route. IP location is a service estimate. - Remote changes are explicit. The separate Skill contacts only the VPS you provide after server-change approval. Required credentials remain in private local/server configuration, outside Git and public logs.
- Permissions are feature-specific. Timezone changes require macOS administrator authorization. Keychain access follows system prompts. Location controls may require Accessibility permission or a manual action in System Settings.
Custom CLAUDE_CONFIG_DIR locations are not automatically included in the default cleanup scan. The app reports this limitation rather than silently claiming they were cleaned.
Start with CONTRIBUTING.md. Small, focused changes with clear behavior and relevant checks are welcome. For bug reports, include the operating system and version, app version, operation and sanitized error; never attach private keys, passwords or subscription URLs.
CCBaga's original project code is released under the MIT License. Third-party code and binaries retain their own terms; see NOTICE.md.
Built with Tauri, React and Fingerprint Chromium, with a native macOS implementation of Claude maintenance workflows. Cleanup discovery was informed by the claude-cleanup skill.