Does nimbalyst auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Productivity

Plugin

nimbalyst

Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.

FLOW.md

nimbalyst@nimbalyst

GitHub

Plugin Signal89/100Strong

maintained99

capable80

documented100

adopted67

Install

$ npx -y skills add nimbalyst/nimbalyst --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

TypeScript React HTML Prisma Linux

+7 tags

Git GitHub Playwright Markdown Anthropic MCP iOS

1,443

Stars

202

Forks

Active

Maintenance

TypeScript

Language

MIT

License

2d ago

Last commit

9mo ago

Created

Repo: nimbalyst/nimbalyst

In this plugin

35 commands 7 skills 3 agents

See everything inside

What's inside

Skills

/datamodellmCreate visual data models for database schemas using Nimbalyst's DataModelLM editor. Use when the user wants to design a data model, database schema, entity relationship diagram, or Prisma schema./git-commitCreate git commits using Nimbalyst's interactive commit proposal widget. ONLY use when the user explicitly clicks "Commit with AI" button or asks for "smart commit". For regular commit requests, use standard git commands instead./excalidrawCreate diagrams and visual drawings using Excalidraw (.excalidraw files). Use when the user wants flowcharts, architecture diagrams, system diagrams, sketches, or any visual diagram. For database schemas and entity relationship diagrams, use the DataModelLM extension instead./extension-developmentBuild, install, and hot-reload Nimbalyst extensions using MCP tools. Use when developing, testing, or iterating on Nimbalyst extensions./feedback-intakeHelp the user file a bug report or feature request for Nimbalyst. Activates when the user opens the in-app feedback flow or runs /feedback:bug-report or /feedback:feature-request. Coordinates evidence gathering, anonymization, and posting to GitHub Issues./mockuplmCreate visual UX mockups using HTML/CSS files (.mockup.html). Use when the user wants to design UI, wireframes, visual layouts, or plan features visually.

Show all 7 skills

/planningCreate structured plan documents and track work items using YAML frontmatter. Use when the user wants to plan a feature, track progress, log bugs/tasks/ideas, or organize project work.

Agents

e2e-runnerRun E2E tests in a dev container for isolated, reproducible test execution. Use proactively when asked to run Playwright tests, E2E tests, or when in a worktree. Handles the full Docker container lifecycle automatically.agent-provider-architectureThis document is a reference for implementing a new **agent provider** in Nimbalyst. It is the architectural counterpart to `docs/AI_PROVIDER_TYPES.md` (which is end-user / product oriented) and walks through every seam a new agent has to fit through: session start and resume,codex-pre-edit-tracking-investigationStatus: **STUCK**. Three approaches tried, none reliably solves the pre-edit race for `update`-kind file_change items. This doc captures everything learned so the next session can pick up cleanly without re-deriving.

Commands

/android-releasePrepare and execute an Android release (patch/minor/major)/bug-reportGather details and draft an actionable bug report for developers./commitCreate a git commit with concise, bullet-point commit message /designCreate a new plan document for tracking work./e2e-devcontainerRun E2E tests in a dev container (isolated environment)/implementExecute a plan document while keeping progress synchronized.

Show all 35 commands

/investigate-performanceInvestigate a Nimbalyst performance problem (freeze, lag, idle CPU, slow op, memory growth) with measured evidence before proposing a fix./investigateInvestigate a problem and align on the right next step before implementing./ios-releasePrepare and execute an iOS release (patch/minor/major)/mockupCreate a visual UX mockup for a requested feature or screen./mychangesSummarize my recent git commits in standup format /playwrightWrite or update Playwright E2E tests following project conventions /posthog-analysisAnalyze PostHog usage data with correct filters, timelines, and caveats./prepare-commitComment out inappropriate logging before commit /promote-public-releaseBuild, refine, and publish cumulative public release notes, then promote the current alpha prerelease to stable /pull-prsPull open GitHub PRs into the github-pr tracker as backlog items /push-and-releaseGit pull, resolve conflicts, push, fix hook errors, then release /refactor-claude-mdRefactor CLAUDE.md by extracting sections to dedicated docs with path-scoped rules /release-alphaPrepare and execute an alpha release (patch/minor/major)/release-extensionRelease a new version of a marketplace extension /restartRestart the Nimbalyst application /review-branchReview all changes in current branch (read-only analysis)/social-responseDraft a response to a user reaching out on Discord or another social channel /tipAuthor a new contextual tip for Nimbalyst's tips system (transcript-inline tip cards with trigger/targeting rules)./tooltipAdd help content tooltips to existing UI elements./trackCreate a tracking item in the Nimbalyst tracker system./update-libsUpdate Anthropic Agent SDK, MCP library, and Codex SDK to latest versions /walkthroughCreate a guided walkthrough for a feature or workflow./write-testsGenerate comprehensive test coverage for existing code./automationCreate or manage an automation /datamodelCreate or modify Prisma-based data models for Nimbalyst's DataModelLM visual editor /new-extensionCreate a new Nimbalyst extension project from a starter scaffold /feature-requestGuide the user through filing a feature request on the public Nimbalyst GitHub repo /launch-new-sessionSpin off a new AI session to work on a side task in parallel /session-cleanupTidy your Sessions board -- fix each session's phase, mark finished work complete, and flag old sessions to archive

README

Read on GitHub

Nimbalyst is the visual workspace for building with Codex and Claude Code

Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.

Maximize speed, bandwidth, and context with Codex, Claude Code, Opencode (alpha), Copilot (alpha) by collaborating visually on integrated files, sessions, and tasks
Iterate visually with coding agents in your markdown, mockups, diagrams, csv, Excalidraw, data models, and code. Approve the coding agent's changes in red/green WYSIWYG, edit, annotate.
Manage multiple sessions in parallel and in kanban. Search, resume, link sessions to files and files to sessions. For developers we include git management, AI commit, workstreams, worktrees, and terminal.
Manage tasks. Keep track of your plans, bugs, todos, etc. Have the agent edit tasks and items, add them, move them, and execute them. Humans see and edit this as well.
Extend Nimbalyst. Build your own custom editors and visual interfaces integrated with the rest of Nimbalyst and your agents.
Mobile app. Start, manage, and respond to your Codex and Claude Code sessions while on the go.

Version

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

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

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

Open storage of content and status in markdown, workflow in slash commands, and plain files on disk or in git.

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	Download AppImage	Linux

Getting Started

Create or open a document — click "New" or press Cmd/Ctrl+N
Write in markdown — write/edit in the WYSIWYG editor
Use the AI assistant — ask AI to research, edit the document, work across your files
Accept/reject AI changes — step through suggested AI edits and accept or reject
Work in Agent Manager — switch to the agent manager view and run multiple agent sessions in parallel
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

Documentation — watch videos and read the docs
Discord — join the discussion
Website — learn more about Nimbalyst

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 approve everything before it goes to GitHub.
🗺️ Curious what we're building? → See the roadmap
🤝 Want to help with roadmap work? → Community view
✨ Have a concrete feature request? → Send it in-app with Send Feedback (left rail or Help menu) and your agent will help draft it.
🌱 Looking for a smaller place to start? → Good first issues

We rank features and bugs by 👍 reactions. Don't comment "+1" — react with 👍 instead. Sort issues by reactions →

Acknowledgments

Built with:

File tree

1708

nimbalyst/nimbalystView on GitHub

.claude/
  agent-mistakes.md
  agents/
    e2e-runner.md
  commands/
    android-release.md
    bug-report.md
    commit.md
    design.md
    e2e-devcontainer.md
    implement.md
    investigate-performance.md
    investigate.md
    ios-release.md
    mockup.md
    mychanges.md
    playwright.md
    posthog-analysis.md
    prepare-commit.md
    promote-public-release.md
    pull-prs.md
    push-and-release.md
    refactor-claude-md.md
    release-alpha.md
    release-extension.md
    restart.md
    review-branch.md
    social-response.md
    tip.md
    tooltip.md
    track.md
    update-libs.md
    walkthrough.md
    write-tests.md
  rules/
    editor-state.md
    electron-database.md
    end-to-end-verification.md
    error-handling.md
    extensions.md
    floating-ui.md
    help-walkthroughs.md
    ipc-listeners.md
    jotai.md
    jwt-scopes.md
    main-process-init.md
    naming-conventions.md
    state-persistence.md
    token-discipline.md
    ui-patterns.md
  settings.json
.devcontainer/
  create-container.sh
  devcontainer.json
  Dockerfile
  e2e-vite.config.ts
  post-create.sh
  run-e2e-tests.sh
.env.example
.githooks/
  pre-push
.github/
  assets/
    ai-sessions-dark.webp
    developers-dark.webp
    extension-marketplace-dark.png
    nimbalyst-hero-agent-dark.png
    nimbalyst-hero-files-dev-dark.png
    sessions-kanban-dark.webp
  ISSUE_TEMPLATE/
    bug_report.yml
    config.yml
    feature_request.yml
  pull_request_template.md
  SETUP_SECRETS.md
  workflows/
    android-build.yml
    ci.yml
    electron-build.yml
    internal-build.yml
    ios-transcript-tests.yml
    publish-extension-sdk.yml
.gitignore
.npmrc
.nvmrc
AGENTS.md
ANDROID_CHANGELOG.md
apple-touch-icon.png
assets/
  nimbalyst-icon.png
  nimbalyst-icon.svg
  nimbalyst-logo.png
  nimbalyst-logo.svg
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
crystal-run.ps1
crystal-run.sh
design/
  agents/
    agent-provider-architecture.md
    codex-pre-edit-tracking-investigation.md
    programmable-action-buttons.mockup.html
  Collaboration/
    collab-content-adapter.md
    collab-local-backup.md
    collaboration-navigation-design.md
    collaborative-tracker-system.md
    README.md
    realtime-document-collaboration.md
    session-share-cloudflare-hosting.md
    shared-doc-key-and-share-roundtrip-root-cause.md
    shared-file-viewer.md
    tracker-mode-layout.mockup.html
  Extensions/
    datamodellm-extension-plan.md
    extension-developer-kit-plan.md
    extension-ideas.md
    extension-live-test-infrastructure.md
    extension-sdk-release-review.md
    extension-system-security-review.md
    nimbalyst-extension-api.md
    nimbalyst-extension-system.md
    transcript-preview-smoke.excalidraw
  MobileSync/
    android-play-launch-plan.md
    android-play-store-listing.md
    app-store-deployment-plan.md
    MobileSyncLocalTesting.md
    native-ios-navigation-hybrid-architecture.md
    SECURITY_REVIEW_NATIVE_IOS.md
    SECURITY_REVIEW.md
    SYNC_ARCHITECTURE.md
    web-extension-viewer.md
  permissions/
    security-review-agent-permissions.md
  trackers/
    unified-tracker-system.md
  transcript-embed-samples/
    blog.prisma
    launch.slides.md
    revenue.csv
    roadmap.mindmap
  VoiceMode/
    mobile-voice-control-system.md
    native-ios-voice-mode.md
    openai-voice-mode-integration.md
    unified-voice-mode-architecture.md
docs/
  AGENT_PERMISSIONS.md
  Agent-Instructions.md
  AI_PROVIDER_TYPES.md
  ALPHA_CHANNEL_SETUP.md
  ALPHA_FEATURES.md
  ANALYTICS_GUIDE.md
  ANDROID_MARKETING_SCREENSHOTS.md
  ARCHITECTURE_DIAGRAMS.md
  assets/
    nimbalyst-schema.prisma.png
    wireframe-settings-system.mockup.png
  CLAUDECODEPROVIDER_REFACTORING.md
  claudecodeprovider-architecture.md
  COLLABORATION_GUIDE.md
  CONTEXT_WINDOW_USAGE_TRACKING.md
  CSS_VARIABLES.md
  CUSTOM_TOOL_WIDGETS.md
  DARK_MODE_GUIDE.md
  DATABASE_SCHEMA.md
  DEBUGGING_LOGS.md
  DEVELOPING_NIMBALYST.md
  DIALOGS.md
  DOCUMENT_CONTEXT_SERVICE.md
  E2E_TESTING.md
  EDITOR_E2E_TESTING.md
  EDITOR_STATE.md
  ELECTRON_PACKAGING.md
  ERROR_HANDLING.md
  EXTENSION_ARCHITECTURE.md
  EXTENSION_PANELS.md
  EXTENSION_SDK_RELEASE_REVIEW.md
  EXTENSION_THEMING.md
  FEATURE_INVENTORY.md
  FILE_TYPE_HANDLING.md
  FILE_WATCHER_DIFF_SYSTEM.md
  FILE_WATCHING_AND_CHANGE_TRACKING.md
  GIT_INTEGRATION.md
  HELP_WALKTHROUGHS.md
  INTERACTIVE_PROMPTS.md
  INTERNAL_MCP_SERVERS.md
  IOS_MARKETING_SCREENSHOTS.md
  IPC_GUIDE.md
  IPC_LISTENERS.md
  JOTAI.md
  MARKETING_SCREENSHOTS.md
  MCP_CONFIG_MIGRATION.md
  MCP_OAUTH.md
  MCPCONFIGSERVICE_IMPLEMENTATION.md
  NAMING_CONVENTIONS.md
  nimbalyst-schema.prisma
  PLANNING_SYSTEM.md
  PLAYWRIGHT.md
  POSITIONING_IN_EDITOR.md
  POSTHOG_EVENTS.md
  REACT_DOM_MARKERS.md
  RENDER_PERFORMANCE.md
  SENDMESSAGE_REFACTORING.md
  SESSION_HIERARCHY.md
  STATE_PERSISTENCE.md
  SYNC_JWT_MODEL.md
  SYSTEM_PROMPT_CUSTOMIZATION.md
  TEAMMATE_IMPLEMENTATION.md
  TEAMS_ANALYTICS.md
  THE_HARNESS.md
  TRACKER_FILTERS.md
  TRACKER_WORKFLOWS.md
  TRANSCRIPT_ARCHITECTURE.md
  UI_PATTERNS.md
  VISUAL_COMMUNICATION_PROMPT.md
  VOICE_MODE.md
  WALKTHROUGHS.md
  WEEKLY_DASHBOARD.md
  WINDOW_ROUTING.md
  WINDOWS_PREPUSH_GATE.md
  WORKTREE_RELIABILITY_IMPROVEMENTS.md
  WORKTREES.md
IOS_CHANGELOG.md
LICENSE
LICENSING.md
MARKDOWN_COMPATIBILITY.md
package-lock.json
package.json
packages/
  android/
    .gitignore
    app/
      build.gradle.kts
      proguard-rules.pro
      src/
        debug/
          java/
            com/
              nimbalyst/
                app/
                  screenshots/
                    ScreenshotDemoData.kt
                    ScreenshotHost.kt
                    ScreenshotMode.kt
        main/
          AndroidManifest.xml
          java/
            com/
              nimbalyst/
                app/
                  analytics/
                    AnalyticsManager.kt
                  attachments/
                    ImageCompressor.kt
                    PendingAttachment.kt
                  auth/
                    AccountDeletionClient.kt
                    AuthCallbackData.kt
                    AuthCallbackParser.kt
                    MagicLinkClient.kt
                  crypto/
                    CryptoManager.kt
                  data/
                    MessageDao.kt
                    MessageEntity.kt
                    NimbalystDatabase.kt
                    NimbalystRepository.kt
                    ProjectDao.kt
                    ProjectEntity.kt
                    QueuedPromptDao.kt
                    QueuedPromptEntity.kt
                    SessionDao.kt
                    SessionEntity.kt
                    SyncStateDao.kt
                    SyncStateEntity.kt
                  MainActivity.kt
                  NimbalystApplication.kt
                  notifications/
                    NimbalystFirebaseMessagingService.kt
                    NotificationManager.kt
                  pairing/
                    PairingModels.kt
                    PairingStore.kt
                    QRPairingData.kt
                  sync/
                    SyncConnectionState.kt
                    SyncManager.kt
                    SyncProtocol.kt
                    WebSocketClient.kt
                  transcript/
                    TranscriptBridge.kt
                    TranscriptPayloadBuilder.kt
                    TranscriptWebView.kt
                    TranscriptWebViewPool.kt
                  ui/
                    AndroidScreen.kt
                    components/
                      ConnectionIndicator.kt
                    LoginScreen.kt
                    NimbalystAndroidApp.kt
                    OnboardingScreen.kt
                    PairingCredentialsForm.kt
                    PairingQrScanner.kt
                    PairingScreen.kt
                    ProjectListScreen.kt
                    ProjectsScreen.kt
                    ScreenScaffold.kt
                    SessionDetailScreen.kt
                    SessionListScreen.kt
                    SettingsScreen.kt
                    theme/
                      Theme.kt
                  utils/
                    RelativeTimestamp.kt
          res/
            drawable/
              ic_notification.xml
            mipmap-anydpi-v26/
              ic_launcher_round.xml
              ic_launcher.xml
            mipmap-hdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-mdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xxhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xxxhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            values/
              ic_launcher_background.xml
              strings.xml
              themes.xml
        release/
          java/
            com/
              nimbalyst/
                app/
                  screenshots/
                    ScreenshotHost.kt
                    ScreenshotMode.kt
        test/
          java/
            com/
              nimbalyst/
                app/
                  auth/
                    AccountDeletionClientTest.kt
                    AuthCallbackParserTest.kt
                    MagicLinkRequestTest.kt
                  crypto/
                    CryptoManagerTest.kt
                    CryptoWireCompatTest.kt
                  data/
                    NimbalystDaoTest.kt
                  MainActivityDeepLinkTest.kt
                  pairing/
                    PairingModelsTest.kt
                    QRPairingDataTest.kt
                  screenshots/
                    ScreenshotDemoDataTest.kt
                  sync/
                    HandleIndexSyncResponseTest.kt
                    ShouldAcceptRemoteDraftTest.kt
                    SyncCollabIntegrationTest.kt
                    SyncProtocolTest.kt
                  transcript/
                    TranscriptBridgeTest.kt
                    TranscriptPayloadBuilderTest.kt
                  ui/
                    SessionDetailScreenDraftSyncTest.kt
                    SessionListGroupingTest.kt
          resources/
            crypto/
              test-vectors.json
            robolectric.properties
    build.gradle.kts
    CLAUDE.md
    gradle/
    gradle.properties
      wrapper/
        gradle-wrapper.jar
        gradle-wrapper.properties
    gradlew
    gradlew.bat
... 1600 more

Showing a partial view of a very large repo.

FAQ

nimbalyst is a Claude Code plugin with 7 hand-picked skills for productivity work, indexed on Flowy. Install it with the command on its page. It includes datamodellm, git-commit, excalidraw. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is nimbalyst?: Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.
How do I install nimbalyst?: Run these in Claude Code: npx -y skills add nimbalyst/nimbalyst --agent claude-code. Then prompt normally.
Does nimbalyst auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is nimbalyst free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Productivity

Plugin

nimbalyst

Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.

FLOW.md

nimbalyst@nimbalyst

GitHub

Plugin Signal89/100Strong

maintained99

capable80

documented100

adopted67

Install

$ npx -y skills add nimbalyst/nimbalyst --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

TypeScript React HTML Prisma Linux

+7 tags

Git GitHub Playwright Markdown Anthropic MCP iOS

1,443

Stars

202

Forks

Active

Maintenance

TypeScript

Language

MIT

License

2d ago

Last commit

9mo ago

Created

Repo: nimbalyst/nimbalyst

In this plugin

35 commands 7 skills 3 agents

See everything inside

What's inside

Skills

Show all 7 skills

/planningCreate structured plan documents and track work items using YAML frontmatter. Use when the user wants to plan a feature, track progress, log bugs/tasks/ideas, or organize project work.

Agents

Commands

Show all 35 commands

README

Read on GitHub

Nimbalyst is the visual workspace for building with Codex and Claude Code

Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.

Maximize speed, bandwidth, and context with Codex, Claude Code, Opencode (alpha), Copilot (alpha) by collaborating visually on integrated files, sessions, and tasks
Iterate visually with coding agents in your markdown, mockups, diagrams, csv, Excalidraw, data models, and code. Approve the coding agent's changes in red/green WYSIWYG, edit, annotate.
Manage multiple sessions in parallel and in kanban. Search, resume, link sessions to files and files to sessions. For developers we include git management, AI commit, workstreams, worktrees, and terminal.
Manage tasks. Keep track of your plans, bugs, todos, etc. Have the agent edit tasks and items, add them, move them, and execute them. Humans see and edit this as well.
Extend Nimbalyst. Build your own custom editors and visual interfaces integrated with the rest of Nimbalyst and your agents.
Mobile app. Start, manage, and respond to your Codex and Claude Code sessions while on the go.

Version

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

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

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

Open storage of content and status in markdown, workflow in slash commands, and plain files on disk or in git.

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	Download AppImage	Linux

Getting Started

Create or open a document — click "New" or press Cmd/Ctrl+N
Write in markdown — write/edit in the WYSIWYG editor
Use the AI assistant — ask AI to research, edit the document, work across your files
Accept/reject AI changes — step through suggested AI edits and accept or reject
Work in Agent Manager — switch to the agent manager view and run multiple agent sessions in parallel
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.

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

Documentation — watch videos and read the docs
Discord — join the discussion
Website — learn more about Nimbalyst

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 approve everything before it goes to GitHub.
🗺️ Curious what we're building? → See the roadmap
🤝 Want to help with roadmap work? → Community view
✨ Have a concrete feature request? → Send it in-app with Send Feedback (left rail or Help menu) and your agent will help draft it.
🌱 Looking for a smaller place to start? → Good first issues

We rank features and bugs by 👍 reactions. Don't comment "+1" — react with 👍 instead. Sort issues by reactions →

Acknowledgments

Built with:

File tree

1708

nimbalyst/nimbalystView on GitHub

.claude/
  agent-mistakes.md
  agents/
    e2e-runner.md
  commands/
    android-release.md
    bug-report.md
    commit.md
    design.md
    e2e-devcontainer.md
    implement.md
    investigate-performance.md
    investigate.md
    ios-release.md
    mockup.md
    mychanges.md
    playwright.md
    posthog-analysis.md
    prepare-commit.md
    promote-public-release.md
    pull-prs.md
    push-and-release.md
    refactor-claude-md.md
    release-alpha.md
    release-extension.md
    restart.md
    review-branch.md
    social-response.md
    tip.md
    tooltip.md
    track.md
    update-libs.md
    walkthrough.md
    write-tests.md
  rules/
    editor-state.md
    electron-database.md
    end-to-end-verification.md
    error-handling.md
    extensions.md
    floating-ui.md
    help-walkthroughs.md
    ipc-listeners.md
    jotai.md
    jwt-scopes.md
    main-process-init.md
    naming-conventions.md
    state-persistence.md
    token-discipline.md
    ui-patterns.md
  settings.json
.devcontainer/
  create-container.sh
  devcontainer.json
  Dockerfile
  e2e-vite.config.ts
  post-create.sh
  run-e2e-tests.sh
.env.example
.githooks/
  pre-push
.github/
  assets/
    ai-sessions-dark.webp
    developers-dark.webp
    extension-marketplace-dark.png
    nimbalyst-hero-agent-dark.png
    nimbalyst-hero-files-dev-dark.png
    sessions-kanban-dark.webp
  ISSUE_TEMPLATE/
    bug_report.yml
    config.yml
    feature_request.yml
  pull_request_template.md
  SETUP_SECRETS.md
  workflows/
    android-build.yml
    ci.yml
    electron-build.yml
    internal-build.yml
    ios-transcript-tests.yml
    publish-extension-sdk.yml
.gitignore
.npmrc
.nvmrc
AGENTS.md
ANDROID_CHANGELOG.md
apple-touch-icon.png
assets/
  nimbalyst-icon.png
  nimbalyst-icon.svg
  nimbalyst-logo.png
  nimbalyst-logo.svg
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
crystal-run.ps1
crystal-run.sh
design/
  agents/
    agent-provider-architecture.md
    codex-pre-edit-tracking-investigation.md
    programmable-action-buttons.mockup.html
  Collaboration/
    collab-content-adapter.md
    collab-local-backup.md
    collaboration-navigation-design.md
    collaborative-tracker-system.md
    README.md
    realtime-document-collaboration.md
    session-share-cloudflare-hosting.md
    shared-doc-key-and-share-roundtrip-root-cause.md
    shared-file-viewer.md
    tracker-mode-layout.mockup.html
  Extensions/
    datamodellm-extension-plan.md
    extension-developer-kit-plan.md
    extension-ideas.md
    extension-live-test-infrastructure.md
    extension-sdk-release-review.md
    extension-system-security-review.md
    nimbalyst-extension-api.md
    nimbalyst-extension-system.md
    transcript-preview-smoke.excalidraw
  MobileSync/
    android-play-launch-plan.md
    android-play-store-listing.md
    app-store-deployment-plan.md
    MobileSyncLocalTesting.md
    native-ios-navigation-hybrid-architecture.md
    SECURITY_REVIEW_NATIVE_IOS.md
    SECURITY_REVIEW.md
    SYNC_ARCHITECTURE.md
    web-extension-viewer.md
  permissions/
    security-review-agent-permissions.md
  trackers/
    unified-tracker-system.md
  transcript-embed-samples/
    blog.prisma
    launch.slides.md
    revenue.csv
    roadmap.mindmap
  VoiceMode/
    mobile-voice-control-system.md
    native-ios-voice-mode.md
    openai-voice-mode-integration.md
    unified-voice-mode-architecture.md
docs/
  AGENT_PERMISSIONS.md
  Agent-Instructions.md
  AI_PROVIDER_TYPES.md
  ALPHA_CHANNEL_SETUP.md
  ALPHA_FEATURES.md
  ANALYTICS_GUIDE.md
  ANDROID_MARKETING_SCREENSHOTS.md
  ARCHITECTURE_DIAGRAMS.md
  assets/
    nimbalyst-schema.prisma.png
    wireframe-settings-system.mockup.png
  CLAUDECODEPROVIDER_REFACTORING.md
  claudecodeprovider-architecture.md
  COLLABORATION_GUIDE.md
  CONTEXT_WINDOW_USAGE_TRACKING.md
  CSS_VARIABLES.md
  CUSTOM_TOOL_WIDGETS.md
  DARK_MODE_GUIDE.md
  DATABASE_SCHEMA.md
  DEBUGGING_LOGS.md
  DEVELOPING_NIMBALYST.md
  DIALOGS.md
  DOCUMENT_CONTEXT_SERVICE.md
  E2E_TESTING.md
  EDITOR_E2E_TESTING.md
  EDITOR_STATE.md
  ELECTRON_PACKAGING.md
  ERROR_HANDLING.md
  EXTENSION_ARCHITECTURE.md
  EXTENSION_PANELS.md
  EXTENSION_SDK_RELEASE_REVIEW.md
  EXTENSION_THEMING.md
  FEATURE_INVENTORY.md
  FILE_TYPE_HANDLING.md
  FILE_WATCHER_DIFF_SYSTEM.md
  FILE_WATCHING_AND_CHANGE_TRACKING.md
  GIT_INTEGRATION.md
  HELP_WALKTHROUGHS.md
  INTERACTIVE_PROMPTS.md
  INTERNAL_MCP_SERVERS.md
  IOS_MARKETING_SCREENSHOTS.md
  IPC_GUIDE.md
  IPC_LISTENERS.md
  JOTAI.md
  MARKETING_SCREENSHOTS.md
  MCP_CONFIG_MIGRATION.md
  MCP_OAUTH.md
  MCPCONFIGSERVICE_IMPLEMENTATION.md
  NAMING_CONVENTIONS.md
  nimbalyst-schema.prisma
  PLANNING_SYSTEM.md
  PLAYWRIGHT.md
  POSITIONING_IN_EDITOR.md
  POSTHOG_EVENTS.md
  REACT_DOM_MARKERS.md
  RENDER_PERFORMANCE.md
  SENDMESSAGE_REFACTORING.md
  SESSION_HIERARCHY.md
  STATE_PERSISTENCE.md
  SYNC_JWT_MODEL.md
  SYSTEM_PROMPT_CUSTOMIZATION.md
  TEAMMATE_IMPLEMENTATION.md
  TEAMS_ANALYTICS.md
  THE_HARNESS.md
  TRACKER_FILTERS.md
  TRACKER_WORKFLOWS.md
  TRANSCRIPT_ARCHITECTURE.md
  UI_PATTERNS.md
  VISUAL_COMMUNICATION_PROMPT.md
  VOICE_MODE.md
  WALKTHROUGHS.md
  WEEKLY_DASHBOARD.md
  WINDOW_ROUTING.md
  WINDOWS_PREPUSH_GATE.md
  WORKTREE_RELIABILITY_IMPROVEMENTS.md
  WORKTREES.md
IOS_CHANGELOG.md
LICENSE
LICENSING.md
MARKDOWN_COMPATIBILITY.md
package-lock.json
package.json
packages/
  android/
    .gitignore
    app/
      build.gradle.kts
      proguard-rules.pro
      src/
        debug/
          java/
            com/
              nimbalyst/
                app/
                  screenshots/
                    ScreenshotDemoData.kt
                    ScreenshotHost.kt
                    ScreenshotMode.kt
        main/
          AndroidManifest.xml
          java/
            com/
              nimbalyst/
                app/
                  analytics/
                    AnalyticsManager.kt
                  attachments/
                    ImageCompressor.kt
                    PendingAttachment.kt
                  auth/
                    AccountDeletionClient.kt
                    AuthCallbackData.kt
                    AuthCallbackParser.kt
                    MagicLinkClient.kt
                  crypto/
                    CryptoManager.kt
                  data/
                    MessageDao.kt
                    MessageEntity.kt
                    NimbalystDatabase.kt
                    NimbalystRepository.kt
                    ProjectDao.kt
                    ProjectEntity.kt
                    QueuedPromptDao.kt
                    QueuedPromptEntity.kt
                    SessionDao.kt
                    SessionEntity.kt
                    SyncStateDao.kt
                    SyncStateEntity.kt
                  MainActivity.kt
                  NimbalystApplication.kt
                  notifications/
                    NimbalystFirebaseMessagingService.kt
                    NotificationManager.kt
                  pairing/
                    PairingModels.kt
                    PairingStore.kt
                    QRPairingData.kt
                  sync/
                    SyncConnectionState.kt
                    SyncManager.kt
                    SyncProtocol.kt
                    WebSocketClient.kt
                  transcript/
                    TranscriptBridge.kt
                    TranscriptPayloadBuilder.kt
                    TranscriptWebView.kt
                    TranscriptWebViewPool.kt
                  ui/
                    AndroidScreen.kt
                    components/
                      ConnectionIndicator.kt
                    LoginScreen.kt
                    NimbalystAndroidApp.kt
                    OnboardingScreen.kt
                    PairingCredentialsForm.kt
                    PairingQrScanner.kt
                    PairingScreen.kt
                    ProjectListScreen.kt
                    ProjectsScreen.kt
                    ScreenScaffold.kt
                    SessionDetailScreen.kt
                    SessionListScreen.kt
                    SettingsScreen.kt
                    theme/
                      Theme.kt
                  utils/
                    RelativeTimestamp.kt
          res/
            drawable/
              ic_notification.xml
            mipmap-anydpi-v26/
              ic_launcher_round.xml
              ic_launcher.xml
            mipmap-hdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-mdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xxhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            mipmap-xxxhdpi/
              ic_launcher_foreground.png
              ic_launcher_round.png
              ic_launcher.png
            values/
              ic_launcher_background.xml
              strings.xml
              themes.xml
        release/
          java/
            com/
              nimbalyst/
                app/
                  screenshots/
                    ScreenshotHost.kt
                    ScreenshotMode.kt
        test/
          java/
            com/
              nimbalyst/
                app/
                  auth/
                    AccountDeletionClientTest.kt
                    AuthCallbackParserTest.kt
                    MagicLinkRequestTest.kt
                  crypto/
                    CryptoManagerTest.kt
                    CryptoWireCompatTest.kt
                  data/
                    NimbalystDaoTest.kt
                  MainActivityDeepLinkTest.kt
                  pairing/
                    PairingModelsTest.kt
                    QRPairingDataTest.kt
                  screenshots/
                    ScreenshotDemoDataTest.kt
                  sync/
                    HandleIndexSyncResponseTest.kt
                    ShouldAcceptRemoteDraftTest.kt
                    SyncCollabIntegrationTest.kt
                    SyncProtocolTest.kt
                  transcript/
                    TranscriptBridgeTest.kt
                    TranscriptPayloadBuilderTest.kt
                  ui/
                    SessionDetailScreenDraftSyncTest.kt
                    SessionListGroupingTest.kt
          resources/
            crypto/
              test-vectors.json
            robolectric.properties
    build.gradle.kts
    CLAUDE.md
    gradle/
    gradle.properties
      wrapper/
        gradle-wrapper.jar
        gradle-wrapper.properties
    gradlew
    gradlew.bat
... 1600 more

Showing a partial view of a very large repo.

FAQ

What is nimbalyst?: Nimbalyst is a free, open-source, local, interactive visual editor & session/task manager for developers, product managers, designers, builders.
How do I install nimbalyst?: Run these in Claude Code: npx -y skills add nimbalyst/nimbalyst --agent claude-code. Then prompt normally.
Does nimbalyst auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is nimbalyst free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.