nimbalyst is a free, open source project & work management project written in TypeScript and released under MIT. It has 1,731 GitHub stars, 254 forks and 642 open issues, and was last pushed 5 hours ago. On this registry it ranks #40 of 62 tracked projects in Project & Work Management, with 5 head-to-head comparisons available. It gained 13 stars over the last 3 tracked days.

What is nimbalyst?

What it is

Nimbalyst is an open-source visual workspace for Claude Code, Codex, OpenCode, and other coding agents. It lives in the agentic coding ecosystem and brings sessions, worktrees, tasks, docs, diagrams, mockups, commits, and code into one desktop application. It is written in TypeScript, uses Electron, and is MIT licensed.

The problem it solves is the awkward handoff between coding agents and human review. Agent output often arrives as terminal text, raw JSON, or scattered files, which makes changes hard to inspect, edit, and approve. Nimbalyst gives users a visual layer where markdown, diagrams, mockups, data models, and code can be edited directly, while content stays as plain files in a git repository.

Key capabilities

  • WYSIWYG editing of markdown, mockups, Mermaid, Excalidraw, CSV, data models, and Monaco code lets people and agents edit the same files.
  • Red/green diff review lets users step through proposed edits in rendered documents and accept or reject each one.
  • Parallel agent sessions run several coding agents at once, each isolated in its own git worktree.
  • Session kanban tracks sessions, supports search and resume, and links sessions to touched files.
  • Task tracking keeps plans, bugs, features, and todos in trackers that agents and humans update.
  • Git support includes branch and worktree management, staging, AI-drafted commits, and an embedded terminal.
  • MCP support connects servers and renders tool results as visual widgets, while custom editors can use the same EditorHost contract.

Who uses it and how

  • Developers who run Claude Code, Codex, OpenCode, or Copilot in parallel sessions need each session isolated in a git worktree.
  • Reviewers inspect agent edits as red/green diffs in markdown, diagrams, mockups, CSV, data models, or code before accepting them.
  • Users track plans, bugs, features, and todos on session kanban and task views while agents update records.
  • Mobile users monitor sessions, reply by text or voice, swipe through diffs, queue tasks, and receive push notifications.
  • Extension authors build first-class editors for unsupported file types using the same EditorHost contract as built-in editors.

Getting started

Users install Nimbalyst as a desktop app for macOS, Windows, and Linux, with a mobile companion app for iOS and Android. The README download section lists platform installers, including a macOS Apple Silicon .dmg.

When to use it — and when not to

Use Nimbalyst when you want a local visual workspace for coding agents and plain files on disk, with markdown, slash commands, and status kept in the repository. Do not choose it if you need fully mature support for every agent, because OpenCode and GitHub Copilot are alpha and the repository has 642 open issues. Do not expect a hosted web service, because the project is described as a desktop app with mobile companion.

project readme (upstream, from github) — read inline

Nimbalyst: Open-source visual workspace for building with Codex, Claude Code, OpenCode, and other coding agents.

Work on everything in one place: sessions, worktrees, tasks, docs, diagrams, mockups, commits, and code.
Visually editable. Deeply linked.
Free and MIT licensed. Desktop app for macOS, Windows, and Linux, with an iOS companion app.

Version Platform

Website · Download · Documentation · Discord

https://github.com/user-attachments/assets/bfd89552-61f4-4db1-8301-cc2495423b89

What you get

  • Visual editing of the agent's work. WYSIWYG editors for markdown, mockups, Mermaid, Excalidraw, CSV, data models, and code in Monaco. You and the coding agent edit the same files.
  • Red/green diff review. Step through the agent's proposed edits in the rendered document and accept or reject each one.
  • Parallel agent sessions. Run several coding agents at once, each isolated in its own git worktree.
  • Session kanban. Track every session on a board. Search, resume, and link sessions to the files they touched.
  • Task tracking. Plans, bugs, features, and todos in trackers your agents read and update alongside you.
  • Heterogeneous agents. Codex and Claude Code side by side, plus OpenCode and GitHub Copilot in alpha and a Gemini provider.
  • Git built in. Branch and worktree management, staging, AI-drafted commits, and an embedded terminal.
  • MCP client and servers. Connect any MCP server, with tool results rendered as visual widgets rather than raw JSON.
  • Extension SDK. Every editor, including the built-in ones, goes through the same EditorHost contract, so an editor you build is first-class. Ask your agent to build one for a file type we do not ship.
  • Plain files on disk. Content and status in markdown, workflows in slash commands, everything in your git repo. No proprietary store to migrate out of.
  • iOS companion. See which agents need you, reply by text or voice, swipe through diffs, queue the next task, and get a push when an agent is waiting.

Features

Visual Editors: Built-in WYSIWYG editors where you and your coding agents collaborate visually. Approve agent changes as red/green diffs, edit, annotate, and iterate.

  • Markdown
  • Mockups with annotations
  • Mermaid
  • Excalidraw
  • CSV
  • Data Models
  • Code with Monaco

Nimbalyst files and editors

Session Management: Manage coding agents' work across parallel sessions in a UI

  • Link sessions to files and files to sessions
  • Open files in your sessions. Group files touched by a session
  • Run parallel sessions
  • Search and resume sessions
  • Manage in a Kanban board

Nimbalyst session kanban

Task Tracking: Keep track of your plans, bugs, features, todos etc.

  • Have the agent edit tasks, add them, move them, and execute them
  • Humans view and edit them too
feature-task-tracker DY6lbNml_Z19R6rW

For Developers

  • Manage git state
  • Use AI to git commit
  • Use the embedded ghostty terminal
  • Leverage worktrees

Nimbalyst developer view

Mobile App

  • Session dashboard: see which agents need you and which are still working
  • Reply to questions via text or voice, agents resume immediately
  • Visual diff review: swipe through changes, tap to approve
  • Queue next tasks: keep the pipeline full, don't let agents sit idle
  • Push notifications: agents tell you when they need you

Extension System

  • Pluggable editors for any file type. Every editor (including built-ins) goes through the same EditorHost contract, so custom editors are first-class.
  • Current extensions include an Astro website editor, visual git log, mindmap, slides, and a 3D object editor.

Nimbalyst extension marketplace

Supported Coding Agents

  • Codex
  • Claude Code
  • Opencode (alpha)
  • Copilot (alpha)

Download

Download the latest version for your platform:

Platform Download Requirements
macOS Apple Silicon Download .dmg macOS Apple Silicon 12+
macOS Intel Download .dmg macOS Intel 12+
Windows Download .exe Windows 10+
Linux (Debian, Ubuntu) Download .deb Debian, Ubuntu, or a derivative
Linux (other) Download AppImage Linux — on Ubuntu 24.04+ see Linux installation

Getting Started

  1. Create or open a document — click "New" or press Cmd/Ctrl+N
  2. Write in markdown — write/edit in the WYSIWYG editor
  3. Use the AI assistant — ask AI to research, edit the document, work across your files
  4. Accept/reject AI changes — step through suggested AI edits and accept or reject
  5. Work in Agent Manager — switch to the agent manager view and run multiple agent sessions in parallel
  6. Search/resume sessions — search and resume sessions, manage your work

Auto-Updates

Nimbalyst automatically checks for updates and notifies you when a new version is available. You can also manually check via Help → Check for Updates.

By default, fresh installs are on the stable release channel and only receive promoted releases. If you want early-access builds, switch to the alpha channel under Settings → Advanced → Release Channel. Alpha builds are rougher and may break; revert to stable any time.

Telemetry

Nimbalyst sends anonymous usage analytics to PostHog so we can understand how the app is used and prioritize improvements. We never collect:

  • Usernames, emails, or IP addresses (no PII)
  • File contents or file paths (categorized buckets only)
  • API keys or authentication tokens
  • Document, session, or chat content

A randomly-generated anonymous ID is used to correlate events from the same install. You can opt out at any time in Settings → Advanced → Analytics.

For the complete list of every event we send and its properties, see POSTHOG_EVENTS.md. For the privacy rules our analytics code follows, see ANALYTICS_GUIDE.md.

Building from Source

Nimbalyst is a TypeScript / Electron monorepo using npm workspaces.

# Install dependencies (npm 7+ required)
npm install

# Start the Electron app in dev mode
cd packages/electron && npm run dev

# Build a local Mac binary
cd packages/electron && npm run build:mac:local

Major workspaces:

  • packages/ios — Native iOS app (SwiftUI)
  • packages/electron — Desktop application (Electron)
  • packages/runtime — Cross-platform runtime services (AI, sync, Lexical editor)
  • packages/collab-protocol — Wire-format types for the collaboration sync protocol (shared with the sync server)
  • packages/extension-sdk — Extension development kit
  • packages/extensions — Built-in extensions

The collaboration sync server (talked to at wss://sync.nimbalyst.com) is a separate project.

For deeper architecture and contributor guidance, see CLAUDE.md and the docs under docs/. For contribution rules and the DCO sign-off requirement, see CONTRIBUTING.md.

Community

License

  • This repository is licensed under the MIT License — see LICENSE.
  • The collaboration sync server (the Cloudflare Worker that powers wss://sync.nimbalyst.com) is a separate project. Clients in this repo talk to it over the wire protocol defined in packages/collab-protocol/.
  • For licensing context and contact information, see LICENSING.md.

Contributing

  • 💡 Have a vague idea or question?Join the discussion
  • 🐛 Found a bug? → Report it in-app with Send Feedback (left rail or Help menu). Your agent helps draft the report, and you ap

readme truncated — read the full docs on github

Frequently asked questions

Is nimbalyst free to use?

nimbalyst is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does nimbalyst do?

Nimbalyst - The open-source visual workspace for Claude Code, Codex, and OpenCode. Run multiple coding agents in parallel, edit their work visually in markdown,

What is nimbalyst written in?

nimbalyst is primarily written in TypeScript. Its source is publicly available at https://github.com/nimbalyst/nimbalyst, and it has 1,731 GitHub stars.