Detailed Install Guides / Mac: 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

Mac: Detailed Install Guide

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

This guide takes you from the macOS disk image to your first agent session. Download the current installer from the Nimbalyst download page.

Install the App

Open the downloaded Nimbalyst .dmg file.
Drag Nimbalyst into Applications.
Open Nimbalyst from Applications.
If macOS asks whether you want to open an app downloaded from the internet, click Open.

The Nimbalyst disk image with an arrow from the app to the Applications folder — Drag Nimbalyst into Applications, then launch it from there.

Nimbalyst updates itself after installation. If macOS blocks the first launch, open System Settings > Privacy & Security and use the option to open Nimbalyst there.

Open a Project

A project is a folder on your Mac. 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 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.

Nimbalyst Application Settings with Claude Agent selected and other agent providers listed in the sidebar — The AI Providers settings on macOS. Leave Custom Claude Installation empty to use Nimbalyst's bundled runtime.

Claude plan login opens 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.

Nimbalyst also offers separate CLI providers for users who deliberately want a locally installed command-line agent. Those providers have their own installation checks. See AI Provider Setup.

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.