Reference
Build from source
Build, run and test Reigh yourself, and help make it better.
Reigh is open source. You can build it, change it, and send improvements back.
Requirements
- macOS 26 and Xcode 26 (Swift 6)
- The Claude Code CLI, signed in, and git
- XcodeGen, which
make bootstrapinstalls with Homebrew
Build and run
git clone https://github.com/TejasBaid/reigh.git
cd reigh
make bootstrap # installs xcodegen if needed
make run # generates Reigh.xcodeproj, builds, launches
Other targets:
| Command | What it does |
|---|---|
make gen |
Generate Reigh.xcodeproj from project.yml |
make build |
Debug build into build/DerivedData |
make release |
Release build |
make test |
Run the test suites |
make fake |
Build the scripted fake-claude CLI and print how to use it |
make clean |
Remove build products and the generated project |
The iPhone app (ReighMobile) builds from the same generated Xcode project.
Develop without spending
fake-claude is a scripted stand-in for the Claude Code CLI. Point Reigh at it to work on the UI and runtime without real model calls:
make fake
REIGH_DATA_DIR=/tmp/reigh-dev REIGH_SEED_DEMO=1 \
REIGH_CLAUDE_PATH="$(pwd)/Packages/ReighKit/.build/debug/fake-claude" \
open build/DerivedData/Build/Products/Debug/Reigh.app
REIGH_SEED_DEMO=1 fills an isolated workspace with a sample company so every screen has something in it.
Tests
make test
The suites use Swift Testing and cover the database, org policy, cron, the memory mirror, the runtime and dispatcher, the MCP protocol end to end, worktrees and diffs, the phone link’s cryptography, and UI pieces. Opt-in tests against the real CLI cost a few cents:
REIGH_REAL_CLAUDE=1 swift test --package-path Packages/ReighKit --filter RealClaudeTests
Project layout
App/ the macOS app target
Mobile/ the iPhone companion
Packages/ReighKit/Sources/
ReighCore/ data model, SQLite schema, org policy, cron, memory mirror
AgentRuntime/ office engine, dispatcher, sessions, prompts
ReighMCP/ the localhost MCP server and office tools
AgentBrowser/ the agents' WebKit browser
GitKit/ worktrees, diffs and pull requests
ReighLink/ the encrypted phone protocol
ReighCompanion/ the Mac side of the phone link
ReighUI/ every screen
DesignSystem/ glass, tint, grain and controls
fake-claude/ the scripted CLI used in tests
Website/ this site
Contributing
- Found a bug? Open an issue with what you did, what you expected, and what happened. Logs and screenshots help.
- Want to change something? Open an issue first for anything large, so we can agree on the approach. Then send a pull request with tests where it makes sense.
- Docs. Every page here has an Edit this page link at the bottom. The site lives in
Website/and is built with Astro.