Code-Manager

Code Manager, a new Tauri 2 desktop app, centralizes local configuration and session data for Claude Code users, offering profiles, memory, skills, history, stats, token usage, and diagnostics in a single interface. The tool manages the ~/.claude directory and related files without replacing Claude Code, aiming to simplify configuration review and troubleshooting.

Code Manager is a local desktop management app for Claude Code users. It brings profiles, providers, the ~/.claude directory, memories, Skills, history, stats, token usage, project status, the system tray, and diagnostic logs together in a single Tauri 2 app, making your local configuration more visible, previewable, and verifiable. This document is for human users and project visitors. Execution rules for AI agents are in CLAUDE.md /maguowei/code-manager/blob/main/CLAUDE.md , the full usage guide is in docs/user-manual.md /maguowei/code-manager/blob/main/docs/user-manual.md , and platform differences are in docs/platform-support.md /maguowei/code-manager/blob/main/docs/platform-support.md . Over long-term use of Claude Code, local configuration and session data tend to scatter across many files: - Different projects need different models, API endpoints, tokens, permissions, hooks, and plugin combinations. ~/.claude/settings.json , CLAUDE.md , rules/ .md , and Skills are hard to review as a whole.- Provider / model configuration is repetitive, and switching profiles easily misses environment variables or overrides user settings. - History, stats, token spend, project Git status, and worktree information lack a single entry point. - Troubleshooting requires quickly viewing redacted application logs instead of hunting for log files everywhere. Code Manager does not replace Claude Code; it provides a management layer for local configuration, session data, and diagnostic information. | Capability | Description | |---|---| ~/.claude Overview | Browse, preview, edit, and locate the Claude Code user directory. | | Profiles / Built-in Providers | Manage the profile layer ultimately written to ~/.claude/settings.json , picking connection endpoints and model mappings from built-in read-only providers. Edit models, environment variables, permissions, Sandbox, hooks, plugins, and the status line. Preview, copy, test models, apply in one click, import an existing settings file, export optionally with secrets, with a pre-save preview , compare diffs, and sync common options / marketplaces / plugins to other profiles. | | Memory Management | Manage user-level CLAUDE.md and rules/ .md , with support for the Karpathy behavior guide preset, import, enable, disable, copy, preview, and path validation. | | Skills Management | Create, edit, delete, enable, and disable Claude Code Skills, and sync them as ~/.codex/skills/<id symlinks. | | History & Sessions | Read ~/.claude/history.jsonl and view history details by project and session. | | Stats & Recent Sessions | Read a local stats snapshot from ~/.claude.json . | | Token Usage & Cost | Scan ~/.claude/projects/ / .jsonl , aggregate tokens and cost by date, project, session, and model, with incremental SQLite caching. | | Project Management | Show project paths, remotes, branches, worktrees, project-level .claude/ , AGENTS.md / CLAUDE.md , and .agents/skills status, with support for opening a terminal/editor, jumping to history/usage, branch and worktree cleanup, and clearing local project data. | | System Tray & Session Focus | Show the current profile and active Claude Code sessions in the menu bar, with session-count styles and a pending-session breathing indicator, attempt to focus existing terminal sessions on supported platforms, and macOS only mirror session state to ANTICATER USB device LED effects. | | Desktop Usage Widget | An always-on-top, translucent mini-window that shows today's token spend, usage, and cache-hit metrics in real time, with drag support, customizable metrics, and adjustable opacity, toggleable in settings. | | Settings & Diagnostics | Support language, theme, default-collapsed sidebar, menu-bar session display, system notifications, third-party model pricing, launch at login, default terminal and editor, session-focus shortcut and LED effects macOS only , desktop usage widget toggle and metric customization, redacted log viewing, system info copy, and log rotation. | On macOS, installing via Homebrew own tap is recommended: brew install --cask maguowei/tap/code-manager Or go to Releases https://github.com/maguowei/code-manager/releases to download the installer for your platform. | Platform | Installer | |---|---| | macOS Apple Silicon / Intel | .dmg or brew install --cask maguowei/tap/code-manager | | Windows | .msi / .exe | | Linux | .deb / .rpm / .AppImage | The current macOS release packages are not notarized by Apple. Homebrew installs automatically remove the quarantine attribute; if you manually download the .dmg and the first launch is blocked by the system, run the following in a terminal: xattr -rd com.apple.quarantine /Applications/code-manager.app The app has built-in automatic updates: it silently checks for new versions on startup, and once one is found you can download and install it with one click in "Settings - App Update", after which it restarts automatically. Users who installed via Homebrew can also keep upgrading with brew upgrade ; both paths work, and after an in-app update the version Homebrew records will automatically align on the next brew upgrade . - After launch, Code Manager reads your local ~/.claude , ~/.claude.json , and ~/.claude/projects/ . - In settings, choose the interface language, theme, default terminal, and default editor. - On the profiles page, import an existing ~/.claude/settings.json , or create a new profile, pick a built-in provider in the "Provider" option, and fill in the auth secret and model configuration. - Click "Test Model" to confirm the configuration works. - Click enable to apply the profile to ~/.claude/settings.json . - Go to the ~/.claude overview to confirm the final configuration is as expected. For more detailed page descriptions, cost accounting rules, common workflows, and FAQ, see docs/user-manual.md /maguowei/code-manager/blob/main/docs/user-manual.md . Code Manager mainly reads and writes local files. Profile merging, directory scanning, usage aggregation, and log viewing all happen locally; model pricing prefers the local cache and built-in fallback data, and attempts to refresh from official models.dev providers after startup. | Purpose | macOS | Linux | Windows | |---|---|---|---| | Application data | ~/.config/code-manager/ | $XDG CONFIG HOME/code-manager/ or ~/.config/code-manager/ | %APPDATA%\code-manager\ | | Usage SQLite | ~/Library/Application Support/com.gotobeta.app.code-manager/usage.db | $XDG CONFIG HOME/com.gotobeta.app.code-manager/usage.db or ~/.config/com.gotobeta.app.code-manager/usage.db | %APPDATA%\com.gotobeta.app.code-manager\usage.db | | Log directory | ~/Library/Logs/com.gotobeta.app.code-manager/ | $XDG DATA HOME/com.gotobeta.app.code-manager/logs/ or ~/.local/share/com.gotobeta.app.code-manager/logs/ | %LOCALAPPDATA%\com.gotobeta.app.code-manager\logs\ | The application data directory contains config-registry.json , memories.json , model-pricing.json , and skills-disabled/ . On macOS, application data deliberately uses ~/.config/code-manager/ for easier cross-platform backup and script access; SQLite uses Tauri's app config dir , and logs use the Tauri plugin's default path. Stack overview: Tauri 2 + React 19 + TypeScript + Vite + Tailwind CSS v4 + Rust. For full agent execution rules, verification notes, and fine-grained path navigation, see CLAUDE.md /maguowei/code-manager/blob/main/CLAUDE.md . - Node.js LTS pnpm , the project currently declares pnpm@11.2.2 - Rust stable - The system dependencies required to run Tauri 2 make init Install dependencies and check the Rust toolchain make dev Start Tauri desktop dev mode make build Build the installer for the current platform make build-frontend TypeScript check and build the frontend make bindings Regenerate Tauri IPC TypeScript bindings make bindings-check Check that Rust command contracts and src/bindings.ts are in sync make lint Frontend Biome + Rust clippy make test Rust tests + frontend tests make check Rust cargo check make fmt-check Read-only format check for frontend + Rust make verify Local CI-like verification entry point make gitleaks Scan current project files for secrets make gitleaks-history Scan Git history for secrets make lint-frontend Read-only static check for the frontend make test-frontend Run frontend tests pnpm install triggers the prepare script and installs lefthook git hooks. Before a commit it runs staged Biome auto-fix, Gitleaks secret scanning, Rust format check, and commitlint; before a branch push it runs make verify ; tag-only pushes are gated remotely by the release workflow's quality job. make fmt and pnpm check rewrite files; for read-only checks use make lint , make lint-frontend , or make fmt-check . Build artifacts are located by default in src-tauri/target/release/bundle/ . | Path | Purpose | |---|---| src/ | React frontend pages, components, hooks, schemas, and tests. | src/components/ | Page-level components and reusable UI; finer component entry points are in CLAUDE.md . | src-tauri/src/ | Rust backend, Tauri commands, and local file and data capabilities. | src-tauri/resources/ | Built-in providers, model pricing, status line scripts, and other resources. | src-tauri/capabilities/ | Tauri permission declarations. | docs/ | User manual, platform differences, and extended documentation. | .claude/rules/ | Path-scoped maintenance rules for AI agents. | When filing an issue, please include as much as possible: - Operating system, Code Manager version, and Claude Code use case - Reproduction steps, expected result, and actual result - Relevant redacted log snippets from "Settings - Diagnostics - View Logs" - For development changes, the verification commands you have run docs/user-manual.md /maguowei/code-manager/blob/main/docs/user-manual.md : the complete user manual docs/platform-support.md /maguowei/code-manager/blob/main/docs/platform-support.md : platform support differences docs/claude-code-best-practices.md /maguowei/code-manager/blob/main/docs/claude-code-best-practices.md : extended best practices for Claude Code / Codex in this repo CLAUDE.md /maguowei/code-manager/blob/main/CLAUDE.md : the repository execution manual for AI agents LICENSE /maguowei/code-manager/blob/main/LICENSE : license MIT