Skip to content

Windows 0.14.1

Install Rationale on Windows

Download, extract and double-click. The wizard installs Rationale for your Windows user and guides you through access and connection checks.

0.14.1 · source 9ee3643 · 2026-11-06

Windows download

  • Download the Windows x64 ZIP
  • Double-click rationale.exe, then choose Install for me. No PowerShell commands are needed for Rationale setup.

Before you start

This release is built on Windows x64 with MSVC and tested in native CI, including installer, update and rollback tests. Its release manifest is signed with minisign; the executable is not Authenticode-signed. Graphical desktop acceptance and live capture/MCP checks of this exact build remain pending.

Use Windows 10/11 x64 with Git and the native Claude Code CLI already installed and signed in as the same normal Windows user. No Rust or administrator access is needed. The wizard detects missing prerequisites; it does not install third-party tools.

Use Claude Desktop Code with Local selected. Chat, Cowork, remote cloud sessions, Windows Codex and ARM64 are outside this release. For WSL, use the Linux guide inside WSL.

Git for Windows · Claude Code

1. Download and open

Download the ZIP, choose Extract All in File Explorer, then double-click rationale.exe in the extracted folder. Choose Install for me. The installed copy opens automatically and a Rationale shortcut appears in Start.

The permanent location is %LOCALAPPDATA%\Rationale\bin\rationale.exe. A different existing installation is retained; use its signed updater for upgrades. If Windows or company policy blocks the executable, report the message without disabling security controls.

ZIP SHA256: e2a36641fadec1449ed1900bcb315bfbc59c5077d423d50d540407ddd53f1887. Executable SHA256: 4d3133273872b9ef57fd7e6ceb20bc0fb449d770fa4ecee2c0b9b3fd055c8207.

2. Connect your project

Choose Browse and select the local Git repository used in your Code session. Choose Sign in and approve the device in your browser. Select the intended Rationale workspace. If the browser does not open, the wizard shows the address and a short-lived code. Never share your password or device token.

Choose Open Rationale if the repository is not bound or capture is off. Workspace membership is required. A workspace owner can bind the repository and enable capture; you can resume your own paused capture. Choose Check again after resolving access.

Choose Enable capture, then Connect MCP. Approve the connection in your browser. If Claude requires project approval or authentication, open /mcp in Claude Code, select Rationale and finish there. Provider login, device approval and MCP access are separate.

3. Verify actual use

Restart Claude Desktop and open a fresh Code > Local session in the selected project. Finish a turn with a real project choice and its reasons, then choose Check again in Rationale. Decision capture should show Ready only when a scoped server receipt exists.

Ask Claude to read that decision in full using Rationale MCP. Check again: Context read should show Ready. Connection configuration alone does not prove a successful read. Background task status is separate; native acceptance must also verify hooks independently of recovery.

If something is pending

Follow the specific check in the wizard and retry with Check again. Cancel operation stops polling and the current command before subsequent setup steps. Completed steps are retained. Reopen Rationale from Start to continue.

Copy diagnostics exports only version, platform and check states. It excludes tokens, authentication codes, paths, identities, remotes and conversations. Send that text with the failed step; do not send credential files.

For an assistant with local computer access

An assistant can read the public installation guide without a Rationale login. It must check the operating system, architecture and published manifest before installing. Version 0.14.1 includes Windows x64. Manifest signing verifies the release; it does not establish native Windows acceptance.

Installation guide v1

Anything else: support@rationalehq.com