# Code-Manager

> Source: <https://github.com/maguowei/code-manager>
> Published: 2026-07-15 15:01:59+00:00

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