Mac: Detailed Install Guide
What follows is a detailed guide to installing Nimbalyst and setting up Claude Code on Mac
Initial Install
Download the Nimbalyst-MacOS.dmg and click to install it

Drag Nimbalyst into your Applications

Open Nimbalyst from your Applications

Open Nimbalyst

Initial Nimbalyst Config
Choose what Project you will work on. A Project is a folder on your local file system. It could be a Git folder or just another folder. You have different projects for different folders. Open one or create a new one.

In this example, I create My Project, to work on with Nimbalyst

Read and click through Nimbalyst's onboarding screens, Click Get Started

Let Nimbalyst know your role and email. We will only send you product updates occasionally.

Install Nimbalyst's Claude Commands
This is optional, but very helpful. These commands help you get the most out of Nimbalyst
You can also go to the .Claude/Commands directory in Nimbalyst and edit these commands and add others.
You can also go to Settings (click the Gear on the bottom left) then Project Settings and add these commands and others that we have there

Type something into the Agent panel to test your Claude Code
If you already have Claude Code installed, it should just work
If not, Nimbalyst (and this guide) will step you through how to install Claude Code

Installing Claude Code
Click LogIn to be guided through Claude Code setup

Nimbalyst pops up the terminal. Click Allow to allow it to install Claude Code for you.

Nimbalyst opens your browser and asks you to authenticate to your Claude Pro or Max accounts
Google Auth or
Email Auth

Authorize Claude Code to connect to your Claude account

Success installing Claude Code and connecting it to Claude

Claude Code in Nimbalyst
These two terminal windows can be closed. Hit the red dot to close them.

Hit the Check Status box in Nimbalyst to Check Status of your Claude Code Setup

Success. Claude Code now works in Nimbalyst.

Use Nimbalyst
Type into the Agent panel and have your coding agent research, write, edit, mockup, diagram and more
Work in documents and code in the center panel
To set up Codex as an additional coding agent, see AI Provider Setup
Last updated
