> ## Documentation Index
> Fetch the complete documentation index at: https://reikon.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Install Reikon, open your first project, and get through the first-run wizard.

# Getting Started

## Install

Download a pre-built release for macOS, Windows, or Linux (AppImage) from the
[Releases page](https://github.com/gormovsisyan/reikon/releases), 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:

```bash theme={null}
xattr -cr /Applications/Reikon.app
```

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:

```bash theme={null}
git clone https://github.com/gormovsisyan/reikon.git
cd reikon
npm install
npm run dev
```

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](./tour/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](./tour/dashboard) to understand what every signal means
* [AI features](./ai-features) if you want explain/summarize capabilities
* [Set up MCP](../guides/mcp-claude-code) if you use Claude Code, Cursor, or another
  AI coding agent and want it to have project context automatically