IDEs Compatible with holaOS: Complete Development Environment Setup

Any IDE or editor that supports TypeScript/JavaScript projects and npm script execution is fully compatible with holaOS, including Visual Studio Code, WebStorm, Cursor, and Neovim.

holaOS is a TypeScript-based, Electron-driven desktop application maintained in the holaboss-ai/holaOS repository. Because it relies on standard Node.js tooling—including npm, Vite, tsup, and the TypeScript compiler—configuring IDEs compatible with holaOS requires no proprietary extensions or specialized workflows beyond standard modern web development practices.

Visual Studio Code and VSCodium

The repository explicitly acknowledges Visual Studio Code as a primary development environment. In apps/desktop/src/components/layout/shell/AppShell.tsx, the source code contains comments referencing the "VS Code convention," confirming first-class support for this editor. Additionally, the development bootstrap script apps/desktop/scripts/run-dev.mjs specifically lists "VS Code/Cursor integrated terminals" as supported environments for launching the application.

VS Code provides native TypeScript support, integrated terminal access for npm commands, and extensions for Electron debugging.

Cursor IDE Support

Cursor is explicitly mentioned alongside VS Code in apps/desktop/scripts/run-dev.mjs as a supported integrated terminal option. As a fork of VS Code, Cursor inherits full TypeScript and npm script compatibility, making it immediately ready for holaOS development without additional configuration or plugins.

JetBrains WebStorm and IntelliJ IDEA

WebStorm and IntelliJ IDEA offer full-featured TypeScript support through built-in language servers, visual npm run-configuration interfaces, and debugging tools capable of attaching to Electron processes. These IDEs can directly execute the npm scripts defined in the project's package.json while providing advanced refactoring and type-checking capabilities.

Terminal-Based Editors

Neovim and Vim

With plugins such as coc.nvim or ale, Neovim and Vim provide TypeScript language server integration identical to graphical IDEs. Developers can invoke npm scripts from the terminal to run builds and launch the application.

Emacs

Using lsp-mode or eglot, Emacs offers full TypeScript language server support and shell access for executing the npm commands required to build and run holaOS.

Sublime Text

Sublime Text with the LSP package handles TypeScript language server integration and can launch external terminals for running the build scripts defined in the repository.

Configuring Your IDE for holaOS

Your IDE will automatically detect settings from these standard configuration files:

• apps/desktop/tsconfig.json – TypeScript compiler settings for type-checking and IntelliSense
• apps/desktop/vite.config.ts – Vite bundler configuration used by the development server
• package.json – npm scripts and dependency definitions

No additional IDE-specific configuration files are required in the repository.

Essential npm Scripts for holaOS Development

All development tasks are exposed as npm scripts in the root package.json, executable from any IDE's integrated terminal:

# Install dependencies

npm run desktop:install

# Build the local runtime bundle

npm run desktop:prepare-runtime:local

# Type-check the codebase (useful for CI or IDE inspections)

npm run desktop:typecheck

# Launch the desktop app in development mode

npm run desktop:dev

These commands leverage Vite and tsup for bundling and the TypeScript compiler for type checking, ensuring consistent behavior across all compatible IDEs.

Summary

• holaOS uses standard TypeScript and Node.js tooling, making it compatible with any modern IDE that supports these technologies.
• Visual Studio Code and Cursor receive explicit acknowledgment in the source code at apps/desktop/scripts/run-dev.mjs and apps/desktop/src/components/layout/shell/AppShell.tsx.
• JetBrains IDEs, Neovim, Emacs, and Sublime Text provide full support through TypeScript language servers and npm script execution.
• Configuration is driven by standard files (tsconfig.json, vite.config.ts, package.json) with no IDE-specific setup required.

Frequently Asked Questions

Is Visual Studio Code required for holaOS development?

No, VS Code is not required, though it is explicitly supported. The source code in apps/desktop/src/components/layout/shell/AppShell.tsx references VS Code conventions, and apps/desktop/scripts/run-dev.mjs lists it as a supported terminal environment. However, any IDE with TypeScript and npm support works equally well.

Can I use Cursor to develop holaOS applications?

Yes, Cursor is fully supported. The run-dev.mjs script explicitly mentions Cursor alongside VS Code as a compatible integrated terminal option. Since Cursor is built on VS Code, it inherits all TypeScript and npm execution capabilities needed for holaOS development.

What npm scripts are available for holaOS development?

The package.json defines several key scripts: desktop:install for dependencies, desktop:prepare-runtime:local for building the runtime bundle, desktop:typecheck for TypeScript validation, and desktop:dev for launching the Electron application in development mode. These can be run from any IDE terminal.

Are JetBrains IDEs compatible with holaOS?

Yes, WebStorm and IntelliJ IDEA are fully compatible. They provide native TypeScript support, visual npm script runners, and Electron debugging capabilities, allowing you to manage the holaOS codebase without leaving the JetBrains ecosystem.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}