# claude-code-mom

**Repository Path**: emma19910916/claude-code-mom

## Basic Information

- **Project Name**: claude-code-mom
- **Description**: Claude Code Monitor
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code MOM

Single-machine native Rust app for monitoring Claude Code execution, viewing worker state, and orchestrating local dispatch actions.

The repository now follows a tauri-based split:

- Desktop runtime: Tauri `src-tauri/` wrapping the Web frontend
- Legacy native app: Rust + `eframe/egui` code remains in the repo as the original desktop UI foundation
- Web app: `web/` frontend using HTML/CSS/JS via Vite
- Shared local backend: Rust monitor API that samples tmux, Claude sessions, and host resources

## Structure

- `src/app`: UI shell and feature panels
- `src/domain`: domain models and enums
- `src/state`: local state and orchestration logic
- `src/bin/monitor-api.rs`: Rust monitor API for the Web frontend
- `src-tauri`: Tauri desktop runtime and capabilities
- `src/i18n`: Simplified Chinese and English labels
- `src/theme`: multiple skin palettes and egui visuals
- `web`: Web frontend source files
- `docs/adr`: architecture decisions
- `docs/plans`: implementation plans

## Features

- Tauri desktop runtime based on `src-tauri`
- Browser-based dashboard with real HTML/CSS/JS rendering
- Modular view structure for overview, workers, and settings
- Built-in `zh-CN` / `en-US` language switching
- Built-in `Carbon` / `Sunlit` / `Graphite` skins
- Local-first mock control center for sessions, queue, timeline, and worker pool
- Rust monitor API for host resource, tmux, and Claude session sampling

## Scripts

- `./dev-start.sh`: start the Web frontend and Rust monitor API in background
- `./dev-stop.sh`: stop the Web frontend and Rust monitor API
- `./dev-build.sh`: build the Web frontend bundle and monitor API
- `./app-start.sh`: start the Tauri desktop runtime in background
- `./app-stop.sh`: stop the Tauri desktop runtime
- `./app-build.sh`: validate/build the Tauri desktop runtime in debug mode without bundling
- `./run-start.sh`: compatibility wrapper to `./app-start.sh`
- `./run-stop.sh`: compatibility wrapper to `./app-stop.sh`
- `./run-build.sh`: compatibility wrapper to `./app-build.sh`

Runtime state is stored under `.local/`:

- `.local/pids`: pid files
- `.local/logs`: stdout/stderr logs
- `.local/web-dist`: production Web bundle

## Local Usage

```bash
./dev-build.sh
./dev-start.sh
./dev-stop.sh

./app-build.sh
./app-start.sh
./app-stop.sh
```