> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/detailed-install-guides/windows-detailed-install-guide.md).

# Windows: Detailed Install Guide

Install Nimbalyst on Windows, open a project, and connect Claude Agent or OpenAI Codex using a plan login or API key.

This guide takes you from the Windows installer to your first agent session. Download the current `.exe` from the [Nimbalyst download page](https://nimbalyst.com/download/).

## Install the App

1. Open the downloaded Nimbalyst installer.
2. Choose the installation options you want and finish setup.
3. Launch Nimbalyst from the Start menu or the shortcut you created.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2FmAFREIYBbckdzLjrkVw8%2Fimage.png?alt=media&amp;token=1209ac95-95c7-4821-a15d-2ff8d9be154b" alt="The Windows installer showing Nimbalyst installation options"><figcaption><p>Choose the shortcuts you want, then continue through the installer.</p></figcaption></figure>

## Open a Project

A project is a folder on your PC. It can be a Git repository or any other folder containing the documents and files you want to work with.

1. On the Project Manager screen, choose **Open Folder** or **New Folder**.
2. Complete the welcome screen. Choose Standard Mode for a simpler writing workspace or Developer Mode for Git, terminal, and worktree features; you can change this later.
3. Use **Start tutorial** if you want a disposable example project, or **Get started…** to open your own folder.

<figure><img src="https://562749618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVUeHZHlFlZrZt02syRC%2Fuploads%2FERG8tVZGleWZowVZf5Lw%2Fimage.png?alt=media&amp;token=347f5aad-358c-4275-954e-9e3ad9337fef" alt="Nimbalyst Project Manager for choosing or creating a project folder" width="563"><figcaption><p>Each project is backed by a folder on your filesystem.</p></figcaption></figure>

## Connect an Agent

The standard Claude Agent and OpenAI Codex integrations are included with Nimbalyst. You do not need to install Git for Windows or a separate CLI for either one.

1. Open **Settings > Application > AI Providers**.
2. Select **Claude Agent** or **OpenAI Codex** and enable it.
3. Authenticate with a supported subscription login, or choose the API-key option and enter your own key.
4. Return to the workspace, create a session, and select that provider in the composer.

Claude plan login opens a terminal for the OAuth flow and may ask you to type `/login`; return to Settings and click **Refresh** when authentication finishes. Codex plan login opens the ChatGPT sign-in flow in your browser.

{% hint style="info" %}
Git for Windows is still useful for Git repositories and is required by some optional CLI-based providers, but it is not required for Nimbalyst's standard bundled Claude Agent or Codex integrations. See [AI Provider Setup](/setup-nimbalyst/ai-provider-setup-and-notifications.md).
{% endhint %}

## Windows Spellchecker

Nimbalyst uses Electron's Windows spellchecker, which defaults to English. You can turn it off in Settings.

## Start Working

Type a request in the agent panel. The agent can research, write and edit files, build mockups and diagrams, and work with the project context that you give it. You review file changes in Nimbalyst before accepting them.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nimbalyst.com/detailed-install-guides/windows-detailed-install-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.