# claude-code-mom

**Repository Path**: xchen02/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-20

## 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.

## Structure

- `src/app`: UI shell and feature panels
- `src/domain`: domain models and enums
- `src/state`: local state and orchestration logic
- `src/i18n`: Simplified Chinese and English labels
- `src/theme`: multiple skin palettes and egui visuals
- `docs/adr`: architecture decisions
- `docs/plans`: implementation plans

## Features

- Native desktop application based on `eframe` and `egui`
- 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

## Scripts

- `./dev-start.sh`: start debug mode in background
- `./dev-stop.sh`: stop debug mode
- `./dev-build.sh`: build debug artifacts
- `./run-start.sh`: start release binary in background
- `./run-stop.sh`: stop release binary
- `./run-build.sh`: build release artifacts

Runtime state is stored under `.local/`:

- `.local/pids`: pid files
- `.local/logs`: stdout/stderr logs

## Local Usage

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

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