{"id":51126303,"url":"https://github.com/sider-ai/wandesk","last_synced_at":"2026-06-25T08:01:19.993Z","repository":{"id":358021619,"uuid":"1239550442","full_name":"Sider-ai/wandesk","owner":"Sider-ai","description":"Wandesk — Give intelligence shape. Let AI sculpt your desktop. An open-source AI desktop with App Workshop, shared context, memory, and native Claude Code / Codex integration.","archived":false,"fork":false,"pushed_at":"2026-06-04T08:39:54.000Z","size":16509,"stargazers_count":52,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-04T10:11:11.806Z","etag":null,"topics":["agent-native","ai-agent","ai-desktop","app-platform","claude-code","codex","electron-alternative","llm","local-first","open-source","productivity","tauri"],"latest_commit_sha":null,"homepage":"https://wandesk.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sider-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T07:44:49.000Z","updated_at":"2026-06-04T08:39:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Sider-ai/wandesk","commit_stats":null,"previous_names":["sider-ai/wandesk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Sider-ai/wandesk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sider-ai%2Fwandesk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sider-ai%2Fwandesk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sider-ai%2Fwandesk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sider-ai%2Fwandesk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sider-ai","download_url":"https://codeload.github.com/Sider-ai/wandesk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sider-ai%2Fwandesk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34765322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-25T02:00:05.521Z","response_time":101,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-native","ai-agent","ai-desktop","app-platform","claude-code","codex","electron-alternative","llm","local-first","open-source","productivity","tauri"],"created_at":"2026-06-25T08:01:18.662Z","updated_at":"2026-06-25T08:01:19.987Z","avatar_url":"https://github.com/Sider-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Wandesk\n\n**Give intelligence shape. Let AI sculpt your desktop.**\n\nAn open-source AI desktop where you build the apps you need just by describing them. Plug in Claude Code, Codex, DeepSeek, OpenAI, Kimi, Qwen — anything OpenAI-compatible. Apps share context. AI remembers you. All local. No signup.\n\n[Website](https://wandesk.ai) · [中文](README.zh-CN.md) · [Discord](https://discord.gg/VUfTzCvz)\n\n![Wandesk Chat](docs/images/wandesk-chat.webp)\n\n\u003c/div\u003e\n\n---\n\n## 🚀 Run from source\n\n\u003e Prerequisites: Git and Node.js 22.5+ (Wandesk uses Node's built-in `node:sqlite`, stable since 22.5).\n\n```bash\ngit clone https://github.com/Sider-ai/wandesk.git\ncd wandesk\nnpm install\nnpm run dev\n```\n\nThen open \u003chttp://localhost:9602\u003e.\n\nPrefer a native window? The same app ships an optional desktop shell:\n\n```bash\nnpm run tauri:dev      # run as a desktop app (needs a Rust toolchain)\nnpm run tauri:build    # build an unsigned .app / .dmg\n```\n\nSee [`tauri/README.md`](tauri/README.md). The browser and server deployment\npaths are unaffected — the shell is purely additive.\n\n\u003e Just want to use it, not run from source? Download the packaged macOS / Windows desktop app at **[wandesk.ai](https://wandesk.ai)** — no Node, no terminal, just open and go.\n\n---\n\n## ✨ What Wandesk gives you\n\nNot a smarter chat box. A real desktop your AI can live and work in.\n\n### 💬 Chat + Apps — your real AI workspace\n\nThe chat box is just the entry point. Real work happens in apps. Notebook, ledger, board, interactive fiction — each built for the long haul.\n\n- Open chat, notebook, and ledger side by side — never flattened into one thread.\n- Notebook, Ledger, Chat, Memory, Open Source Radar — ready out of the box.\n- One consistent design language across every app.\n- Notes stay in the notebook, ledger entries in the ledger — never buried under a chat scroll.\n\n![Chat](docs/images/wandesk-chat.webp)\n\n### 🪄 App Workshop — say it, get the app\n\nOwn 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.\n\n- React UI + backend API + SQLite storage generated together.\n- Fully local — no cloud dependency, works offline.\n- Keep talking to AI to iterate; edits apply in place.\n- No subscription, no ads, no cloud account lock-in.\n\n![App Workshop](docs/images/wandesk-app-workshop.webp)\n\n### ⚙️ AI Inside Every App — natively\n\nIt is not just AI helping you from the outside. Every Wandesk app can fire AI tasks of its own.\n\n- Ledger auto-tags expenses and writes monthly reports.\n- Notebook summarizes a week of notes from one sentence.\n- Interactive fiction continues itself, keeping characters consistent.\n- Apps generated by App Workshop inherit the same AI-calling power.\n\n![Ledger](docs/images/wandesk-ledger.webp)\n\n### 🧠 Shared Context — what you just said, the apps already know\n\nAll apps share one agent core and one workspace.\n\n- Switch to any app, say *\"save what we just discussed\"* — it knows what you mean.\n- No clipboard ping-pong, no Zapier, no MCP bridge gymnastics.\n- Intent → AI → app, end to end.\n\n![Notebook](docs/images/wandesk-notebook.webp)\n\n### 📌 Personal Memory — the more you use it, the more it knows you\n\nWandesk actively remembers your preferences, skills, and corrections.\n\n- *\"I use Swift + SwiftUI\"* — tell it once, applies forever.\n- Corrected once, AI does not repeat the same mistake.\n- Package recurring routines into reusable **Skills**.\n- Every memory is inspectable — never a black box.\n\n![Memory](docs/images/wandesk-memory.webp)\n\n### 🤝 Agent Integration — Claude Code, Codex live in your desktop\n\nThe AI coding tools you already use become Wandesk apps. No window switching, no copy-paste, all agent collaboration in one place.\n\n- If the `claude` or `codex` CLI is installed, Wandesk surfaces it as a desktop app.\n- External agents can operate Wandesk natively — send them one URL, they read your whole desktop.\n- Real code in real repos, not a simulation.\n\n![Claude Code](docs/images/wandesk-claude-code.webp)\n\n---\n\n## 🔌 Bring Your Own Model\n\nWandesk is provider-neutral. Plug in any AI you already use:\n\n- **DeepSeek**\n- **OpenAI**\n- **Anthropic / Claude**\n- **Google Gemini**\n- **Kimi (Moonshot)**\n- **Qwen (Alibaba)**\n- Any OpenAI-compatible endpoint\n\nSwitch providers per-app from the Settings inside Wandesk.\n\n---\n\n## 🧩 Built-in Apps\n\n| App | Purpose |\n|---|---|\n| **Chat** | The intent layer — talk to AI with full workspace context |\n| **App Workshop** | Describe an app idea, get a real local app generated |\n| **Tasks** | Track ongoing agent tasks across the desktop |\n| **Notebook** | Lightweight notes that AI can read and write |\n| **Files** | Browse and operate on the local workspace |\n| **Memory** | Inspect and edit personal long-term memory |\n| **Settings** | Models, providers, language, theme |\n| **Claude Code** | Anthropic's coding workbench, wrapped as a desktop app |\n| **Codex** | OpenAI's Codex workbench, same treatment |\n| **Ledger** | Personal finance with AI auto-categorization |\n| **Open Source Radar** | Track and analyze trending GitHub projects |\n\n---\n\n## 🏗️ Architecture\n\n```text\nui/                React desktop UI (windows, taskbar, launcher, apps)\nserver/main/        core HTTP / WebSocket APIs and system services\nserver/apps/        app-specific backend modules\nserver/shared/      shared backend utilities\napps/               baked APP.md context files (per app)\nlanguage/           locale source for UI text, prompts, and app docs\nscripts/            development and language-baking scripts\nskills/             bundled Codex skills\ndocs/               documentation and images\n```\n\nGenerated and runtime output is **not** source — keep these out of git:\n\n```text\n.aios/            runtime locale and config state\ndatabase/         SQLite app data\nfiles/            user-side files\nui/dist/         built frontend\nnode_modules/\n```\n\n---\n\n## 🧱 Tech Stack\n\n- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS\n- **Backend**: TypeScript HTTP APIs + WebSocket runtime channel, precompiled to `dist/server/` for runtime\n- **Storage**: SQLite via Node's built-in `node:sqlite`\n- **Runtime ports**: main `9602`, apps `9603`\n- **Workspace data**: `~/Library/Application Support/com.vidline.aios.wandesk.client/workspace` (macOS); equivalent paths on Linux / Windows\n\n---\n\n## 🛠️ Development\n\n```bash\nnpm install\nnpm run dev          # English locale dev\nnpm run dev:zh       # Chinese locale dev\nnpm run typecheck\n```\n\nBuild runtime assets:\n\n```bash\nnpm run build\nnpm run build:zh\nnpm run build:server\n```\n\n### Language baking\n\nWandesk uses source files under `language/\u003clocale\u003e/` and bakes them into the runtime workspace:\n\n```bash\ntsx scripts/start.ts en --force\ntsx scripts/start.ts zh --force\n```\n\nThis regenerates runtime app docs under `apps/` and locale state under `.aios/`.\n\n---\n\n## 🌐 Community\n\n- **Website**: \u003chttps://wandesk.ai\u003e\n- **中文站**: \u003chttps://wandesk.cn\u003e\n- **Discord**: \u003chttps://discord.gg/VUfTzCvz\u003e\n- **Issues**: \u003chttps://github.com/Sider-ai/wandesk/issues\u003e\n\nWe 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.\n\n### 🙏 Acknowledgements\n\n- The optional desktop shell ([`tauri/`](tauri/README.md)) was motivated by [**@epicsagas**](https://github.com/epicsagas), whose [PR #1](https://github.com/Sider-ai/wandesk/pull/1) independently built a Tauri v2 wrapper for Wandesk and made the case for shipping one in-tree. Thank you.\n\n---\n\n## 🔗 Related\n\n- [realuckyang/AIOS](https://github.com/realuckyang/AIOS) — earlier exploration of an operating system for the AI era.\n\n---\n\n## 📄 License\n\nISC\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nBuilt with care for people who want to grow their own AI desktop.\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsider-ai%2Fwandesk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsider-ai%2Fwandesk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsider-ai%2Fwandesk/lists"}