Prerequisites: Git and Node.js 22.5+ (Wandesk uses Node's built-in node:sqlite, stable since 22.5).

git clone https://github.com/Sider-ai/wandesk.git
cd wandesk
npm install
npm run dev

Then open http://localhost:9602.

Prefer a native window? The same app ships an optional desktop shell:

npm run tauri:dev      # run as a desktop app (needs a Rust toolchain)
npm run tauri:build    # build an unsigned .app / .dmg

See tauri/README.md. The browser and server deployment paths are unaffected — the shell is purely additive.

Just want to use it, not run from source? Download the packaged macOS / Windows desktop app at wandesk.ai — no Node, no terminal, just open and go.

Not a smarter chat box. A real desktop your AI can live and work in.

The chat box is just the entry point. Real work happens in apps. Notebook, ledger, board, interactive fiction — each built for the long haul.

• Open chat, notebook, and ledger side by side — never flattened into one thread.
• Notebook, Ledger, Chat, Memory, Open Source Radar — ready out of the box.
• One consistent design language across every app.
• Notes stay in the notebook, ledger entries in the ledger — never buried under a chat scroll.

Own software without writing a line of code. Describe the feature you want and Wandesk generates a complete local app — UI, backend, database in one shot.

• React UI + backend API + SQLite storage generated together.
• Fully local — no cloud dependency, works offline.
• Keep talking to AI to iterate; edits apply in place.
• No subscription, no ads, no cloud account lock-in.

It is not just AI helping you from the outside. Every Wandesk app can fire AI tasks of its own.

• Ledger auto-tags expenses and writes monthly reports.
• Notebook summarizes a week of notes from one sentence.
• Interactive fiction continues itself, keeping characters consistent.
• Apps generated by App Workshop inherit the same AI-calling power.

All apps share one agent core and one workspace.

• Switch to any app, say "save what we just discussed" — it knows what you mean.
• No clipboard ping-pong, no Zapier, no MCP bridge gymnastics.
• Intent → AI → app, end to end.

Wandesk actively remembers your preferences, skills, and corrections.

• "I use Swift + SwiftUI" — tell it once, applies forever.
• Corrected once, AI does not repeat the same mistake.
• Package recurring routines into reusable Skills.
• Every memory is inspectable — never a black box.

The AI coding tools you already use become Wandesk apps. No window switching, no copy-paste, all agent collaboration in one place.

• If the claude or codex CLI is installed, Wandesk surfaces it as a desktop app.
• External agents can operate Wandesk natively — send them one URL, they read your whole desktop.
• Real code in real repos, not a simulation.

Wandesk is provider-neutral. Plug in any AI you already use:

• DeepSeek
• OpenAI
• Anthropic / Claude
• Google Gemini
• Kimi (Moonshot)
• Qwen (Alibaba)
• Any OpenAI-compatible endpoint

Switch providers per-app from the Settings inside Wandesk.

ui/                React desktop UI (windows, taskbar, launcher, apps)
server/main/        core HTTP / WebSocket APIs and system services
server/apps/        app-specific backend modules
server/shared/      shared backend utilities
apps/               baked APP.md context files (per app)
language/           locale source for UI text, prompts, and app docs
scripts/            development and language-baking scripts
skills/             bundled Codex skills
docs/               documentation and images

Generated and runtime output is not source — keep these out of git:

.aios/            runtime locale and config state
database/         SQLite app data
files/            user-side files
ui/dist/         built frontend
node_modules/

• Frontend: React 19, TypeScript, Vite, Tailwind CSS
• Backend: TypeScript HTTP APIs + WebSocket runtime channel, precompiled to dist/server/ for runtime
• Storage: SQLite via Node's built-in node:sqlite
• Runtime ports: main 9602, apps 9603
• Workspace data: ~/Library/Application Support/com.vidline.aios.wandesk.client/workspace (macOS); equivalent paths on Linux / Windows

npm install
npm run dev          # English locale dev
npm run dev:zh       # Chinese locale dev
npm run typecheck

Build runtime assets:

npm run build
npm run build:zh
npm run build:server

Wandesk uses source files under language/<locale>/ and bakes them into the runtime workspace:

tsx scripts/start.ts en --force
tsx scripts/start.ts zh --force

This regenerates runtime app docs under apps/ and locale state under .aios/.

• Website: https://wandesk.ai
• 中文站: https://wandesk.cn
• Discord: https://discord.gg/VUfTzCvz
• Issues: https://github.com/Sider-ai/wandesk/issues

We accept PRs, bug reports, app ideas, locale contributions, and Skill submissions. For anything bigger than a small fix, open an issue first so we can talk through the shape of the change.

• The optional desktop shell (tauri/) was motivated by @epicsagas, whose PR #1 independently built a Tauri v2 wrapper for Wandesk and made the case for shipping one in-tree. Thank you.

• realuckyang/AIOS — earlier exploration of an operating system for the AI era.

ISC