Content
# Chroma (AI Agent Friendly Image Editor)
Native macOS image editor built with SwiftUI and Core Image. Developer-oriented: color adjustments, crop/geometry, histogram, magic-wand background removal, and an **MCP** agent bridge so coding agents can open, inspect, edit, and export images.
## Requirements
- macOS 14+
- Xcode 16+
## Build & run
```bash
xcodebuild -scheme Chroma -configuration Debug \
-derivedDataPath ./build \
-destination 'platform=macOS,arch=arm64' \
CODE_SIGN_IDENTITY="-" build
open ./build/Build/Products/Debug/Chroma.app
```
Or open `Chroma.xcodeproj` in Xcode and run.
## Features
- Document-based workflow (JPEG, PNG, HEIC, TIFF, …)
- Exposure, contrast, highlights/shadows, WB, HSL, levels, sharpness
- Crop, rotate, flip
- Pixel sampler and white-balance eyedropper
- Background remove (click seed, drag tolerance; Shift-drag protect rects)
- Export / copy image; undo for params, geometry, and bitmap edits
- Loopback AgentBridge + stdio MCP proxy (`Tools/chroma-mcp`) for agents
## Agent / MCP
See [docs/mcp.md](docs/mcp.md) for `chroma-mcp` setup with cobot-cli, Claude Code, and others.
```bash
cd Tools/chroma-mcp && swift build -c release
# binary: Tools/chroma-mcp/.build/release/chroma-mcp
```
## License
MIT — see [LICENSE](LICENSE).
