Development

Setup

Node.js 20.19+ (or 22 LTS) is required for npm install / npm run dev (Vite 8).

git clone https://github.com/sergeychernov/ide-agents.git
cd ide-agents
npm install

Command	Description
`npm run dev`	Backend :3921 + Vite :5173
`npm run build`	Compile server + web
`npm start`	Run production build
`npm run docs:install`	Install Docusaurus dependencies (first time)
`npm run docs:start`	Docusaurus dev server
`npm run docs:build`	Build documentation site
`npm run lint`	ESLint (`src/`, `web/`, `template/*/.mjs`)
`npm run lint:fix`	ESLint with autofix
`npm test`	Vitest (web + server)
`npm run test:web`	UI / install logic tests
`npm run test:server`	Backend apply/installations tests

See Architecture for module overview.

TypeScript, ESM (NodeNext), compiled to dist/. Entry: dist/cli.js, bin: ide-agents.

Vite + React + Mantine. Built to web/dist/, served by Fastify in production.

Separate npm package (Docusaurus 3). Not bundled into the CLI.

Use any local git repo with skills/*/SKILL.md and/or agents/*.md. In the UI, add a file:// URL (see Source repositories).

ide-agents --port 3922    # preferred port (falls back to next free if busy)
ide-agents --no-open      # do not open browser