Detailed Install Guides / Windows: Detailed Install Guide

Getting Started

Why Nimbalyst? Nimbalyst Tutorial and Demo Videos Quickstart Major Bugs, Outages, Feedback, Discord, Support, Releases Release Announcement Archive

VISUAL EDITORS POWERED BY AI

Markdown (WYSIWYG) Find & Replace and ToC AI Editing, Red/Green Diff, Approval Set Document Type Mermaid Diagrams and Images Mockups Canvas Animations Data Models CSV Browser Calc Sheets Mind Map Excalidraw PDF Viewer Code Editor

FILE MANAGEMENT

File History and Restore File Search, File Tree, and Tabs Multi-Folder Projects Project Graph Share Link to a File File Edits Sidebar

SESSION MANAGEMENT

Agent Window & Session Management AI Usage Report View Files in Agent Mode Workstreams Import Claude Code Sessions / Commands and Skills AI Actions Interactive Prompts (PromptForUserInput) Automations Share Link to a Session

TASK MANAGEMENT

Tracker Overview Item Types and Fields Views: Kanban, List, and Tag Board Item Detail, Comments, Activity Creating Items Referencing Tracker Items Linking Tracker Items Sharing Plans and Trackers AI Integration Linking Sessions and Tracked Items Custom Tracker Types The nim CLI Local Config

DEVELOPER FEATURES

Coding with Coding Agents & Nimbalyst Basics on Code/Git for Non-Devs Turn on/off Developer Mode Terminal Window Worktrees Working with Git Pull Request Reviews Agent Teams

TEAM COLLABORATION

Nimbalyst Teams: Step by Step Team Collaboration Overview Collaborative Documents Collaborative Trackers Ask Your Team for Feedback Decision Blocks in Documents Web Console (console.nimbalyst.com) Set Up Nimbalyst Teams

EXTENSIONS

Extension System & Marketplace Building Your Own Extensions Getting Started Custom Editors AI Tools Manifest Reference API Reference

MOBILE

Mobile App Voice on Mobile

SETUP Nimbalyst

AI Provider Setup and Notifications Application, Account, and Project Settings Set Up Nimbalyst Teams and Organizations Claude Code in Vertex, Bedrock MCP Alpha Features Voice Mode

Open, Safe, Private, Secure

Open Data, Workflow, File Storage Permissions and Safety Privacy Session and Window State Storage Security

FAQs

Troubleshooting

Troubleshooting Database Backups and Restore

Detailed Install Guides

Windows: Detailed Install Guide Mac: Detailed Install Guide

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.

Install the App

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

The Windows installer showing Nimbalyst installation options — Choose the shortcuts you want, then continue through the installer.

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.

On the Project Manager screen, choose Open Folder or New Folder.
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.
Use Start tutorial if you want a disposable example project, or Get started… to open your own folder.

Nimbalyst Project Manager for choosing or creating a project folder — Each project is backed by a folder on your filesystem.

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.

Open Settings > Application > AI Providers.
Select Claude Agent or OpenAI Codex and enable it.
Authenticate with a supported subscription login, or choose the API-key option and enter your own key.
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.

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.

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.