@aiderdesk/aiderdesk
v0.64.0
Published
AiderDesk - AI-Powered Development Platform
Maintainers
Readme
@aiderdesk/aiderdesk
Run AiderDesk as a headless backend service accessible through your browser. This package provides a lightweight alternative to the desktop application — similar to running AiderDesk with Docker.
After starting, the AiderDesk web UI is available at http://localhost:24337.
Installation
npm install -g @aiderdesk/aiderdeskAlternatively, run it directly without installing:
npx @aiderdesk/aiderdeskThe postinstall script automatically downloads the required uv Python package manager and probe binary for your platform.
Usage
Interactive TUI (default)
aiderdesk
# or
aiderdesk tuiOpens an interactive terminal UI where you can start/stop the service, configure the port, and view logs.
Keyboard shortcuts:
| Key | Action |
|-----|--------|
| s | Start / Stop the service |
| p | Change port |
| q | Exit |
| ↑ / ↓ | Scroll logs |
| PgUp / PgDn | Scroll logs by half page |
| Ctrl+C | Exit |
Headless Foreground
aiderdesk startRuns the service in the foreground with logs printed to stdout. Useful for Docker containers, systemd services, or CI environments.
Options
-p, --port <port> Set the port to listen on (default: 24337, env: AIDER_DESK_PORT)
-h, --help Show help message
-v, --version Show version numberPort Configuration
You can set the port in three ways (highest priority first):
- CLI flag:
aiderdesk start --port 8080 - Environment variable:
AIDER_DESK_PORT=8080 - Default:
24337
Accessing the UI
Once running, open your browser and navigate to:
http://localhost:24337From there you can use AiderDesk the same way as the desktop application.
Requirements
- Node.js 20 or later
- Python 3.8+ (automatically managed via
uv)
Differences from the Desktop App
This package runs only the AiderDesk backend service. It does not include the Electron desktop shell. The experience is identical to running AiderDesk in a browser (e.g., via Docker). Features like system tray integration and native desktop notifications are not available.
Links
License
MIT
