Development commands
The npm scripts used for day-to-day development, native-module recovery, testing, and packaging.
Note
This covers the repository's own npm scripts for building and packaging AgentDock — not a command-line interface exposed by the app itself, which doesn't exist. See CLI reference.
Everyday development
| Script | Purpose |
|---|---|
npm run dev | Start AgentDock in development mode via electron-vite. |
npm run build | Production build. |
npm run typecheck | Type-checks both the main/node and web/renderer TypeScript projects. |
npm test | Runs the Vitest suite. |
Native module recovery
| Script | Purpose |
|---|---|
npm run rebuild:native | Rebuilds node-pty against the installed Electron's ABI. |
npm run native:check | Verifies the native module loads correctly. |
npm run test:pty | A dedicated PTY smoke test. |
Packaging (AgentDock Pro)
| Script | Output |
|---|---|
npm run package:win | Windows x64 NSIS installer + portable exe. |
npm run package:linux | Linux x64 AppImage + deb. |
npm run package:mac | macOS x64 dmg + zip. |
npm run package:mac:arm64 | macOS arm64 dmg + zip. |
Warning
npm run rebuild:native && npm run native:check should be run before packaging — packaging does not rebuild native modules itself (npmRebuild: false in electron-builder.yml), so a stale native build ships silently otherwise.