70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
# Claude Code Context
|
|
|
|
Desktop app for exploring Claude Code session context usage.
|
|
|
|
It helps you inspect session timelines, search across sessions, debug context injections (`CLAUDE.md`, mentioned files, tool outputs), and configure notification triggers.
|
|
|
|
## Features
|
|
- Repository/worktree-aware project grouping
|
|
- Session search with context snippets
|
|
- Structured conversation/chunk parsing from Claude JSONL logs
|
|
- Context usage inspection (CLAUDE.md + mentioned files + tool output)
|
|
- Native notifications with configurable trigger rules
|
|
- Real-time updates from Claude session/todo file changes
|
|
|
|
## Tech Stack
|
|
- Electron + electron-vite
|
|
- React + TypeScript + Zustand
|
|
- Tailwind CSS
|
|
- Vitest + ESLint
|
|
|
|
## Requirements
|
|
- Node.js 20+
|
|
- pnpm 10+
|
|
- macOS or Windows
|
|
|
|
## Getting Started
|
|
```bash
|
|
pnpm install
|
|
pnpm dev
|
|
```
|
|
|
|
## Data Source
|
|
The app reads Claude local data from:
|
|
- `~/.claude/projects/`
|
|
- `~/.claude/todos/`
|
|
|
|
## Scripts
|
|
```bash
|
|
pnpm dev # Run app in development
|
|
pnpm typecheck # TypeScript checks
|
|
pnpm lint # ESLint (no auto-fix)
|
|
pnpm test # Unit tests
|
|
pnpm build # Electron/Vite production build
|
|
pnpm check # Full local quality gate
|
|
pnpm dist:mac # Package macOS app (electron-builder)
|
|
pnpm dist:win # Package Windows app (electron-builder)
|
|
pnpm dist # Package both targets
|
|
```
|
|
|
|
## Packaging and Release
|
|
- Packaging is configured with `electron-builder.yml`.
|
|
- CI workflow (`.github/workflows/ci.yml`) runs typecheck/lint/test/build on macOS + Windows.
|
|
- Release workflow (`.github/workflows/release.yml`) builds distributables on tags (`v*`).
|
|
- Code signing/notarization uses GitHub secrets:
|
|
- `CSC_LINK`, `CSC_KEY_PASSWORD`
|
|
- `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, `APPLE_TEAM_ID` (macOS notarization)
|
|
|
|
## Security Notes
|
|
- IPC handlers validate IDs/inputs and apply strict path containment checks.
|
|
- File reads for context injection are constrained to project root and `~/.claude`.
|
|
- Sensitive credential path patterns are blocked.
|
|
|
|
## Contributing
|
|
See:
|
|
- `CONTRIBUTING.md`
|
|
- `CODE_OF_CONDUCT.md`
|
|
- `SECURITY.md`
|
|
|
|
## License
|
|
MIT (`LICENSE`)
|