Skip to main content

​
Getting Started

​
Install

Download a pre-built release for macOS, Windows, or Linux (AppImage) from the Releases page, or run from source. On macOS, builds are not yet code-signed, so Gatekeeper may report the app as “damaged and can’t be opened”. Clear the quarantine flag after moving Reikon to Applications:
On Linux, mark the downloaded Reikon-<version>.AppImage as executable (chmod +x Reikon-*.AppImage) and double-click it — no installer, no package manager, no root required. To run from source:
Running from source requires Node.js 20.19+ or 22.12+, and Git.

​
Open a project

Point Reikon at any git repository on disk — Open Folder from the welcome screen, or drag a folder in. Analysis starts automatically once a project opens. First run on a large repo can take a little longer — full-history git log scanning and AST parsing both happen up front. Subsequent opens are cached and near-instant unless the commit history has changed.

​
Work on several repos at once

Open up to three repositories in tabs and switch between them without re-analyzing. Open a second folder and a browser-style tab strip appears across the top of the window; each tab keeps its own analysis, goals, review state, and dispatch ledger. Click a tab to switch, click its × to close it. When a dispatched fix lands in a background tab, that tab pings — so you can keep working in the foreground repo and come back when the fix returns. The Dashboard’s dispatch ledger spans every open tab, so you can see what’s out, returned, and pending across all of them in one place.

​
The first-run wizard

The first time you open a new project, a short setup wizard walks through:
  1. Overview — project name, commit/contributor/line counts, language breakdown
  2. AI (optional) — connect a coding-agent CLI you already have. Reikon detects installed CLIs (Claude Code, Codex, Gemini) and offers each; skip freely, everything else works without it
  3. Team — AI-suggested groupings if the same person appears under multiple git identities (e.g. a work email and a personal one), so they show up as one contributor instead of two
  4. You’re at the helm — pick where to start: get oriented (the Onboard on-ramp for an unfamiliar repo), set your first goal, or open the Dashboard
You can dismiss the wizard and re-trigger it later from Settings if you want to revisit identity merging after adding more team members.

​
Where to go next

  • Tour each tab to understand what every signal means
  • AI features if you want explain/summarize capabilities
  • Set up MCP if you use Claude Code, Cursor, or another AI coding agent and want it to have project context automatically