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 bootstrap installs 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.