> **Deskctl**: The programmable API for desktop automation
Sign in to like and favorite skills
Deskctl: The programmable API for desktop automation
Full Guide: See DEVELOPMENT.md for complete documentation
# Setup pnpm install && pnpm check-types # Development pnpm dev # All apps in parallel pnpm dev:bridge # Desktop agent (port 9990) pnpm dev:hub # Dashboard (port 5173) pnpm dev:rhub # Real-time hub (port 5174) pnpm dev:web # Web client (port 5175) pnpm dev:docs # Docs site (port 3000) # Quality pnpm check-types # TypeScript validation pnpm lint # ESLint checks pnpm format # Prettier formatting # Build pnpm build # Build all packages pnpm build:bridge # Build desktop app # Components pnpm ui # Add shadcn/ui components
deskctl/ ├── apps/ │ ├── bridge/ 🖥️ Tauri 2 desktop app (Rust + SolidJS) │ ├── hub/ 🌐 React dashboard │ ├── rhub/ 📊 Real-time hub │ ├── web/ 🧪 Web client example │ └── docs/ 📚 Next.js documentation │ ├── packages/ │ ├── sdk/ 📦 TypeScript SDK (@deskctl/sdk) │ └── ui/ 🎨 React components (@deskctl/ui) │ └── tooling/ ├── tsconfig/ TypeScript configs └── eslint-config/ ESLint configs
| App | Port | Stack | Purpose |
|---|---|---|---|
| Bridge | 9990 | Tauri 2 | Desktop agent (HTTP/WebSocket API) |
| Hub | 5173 | React | Web dashboard |
| rHub | 5174 | React | Real-time monitoring |
| Web | 5175 | React | Example client |
| Docs | 3000 | Next.js | Documentation site |
| Type | Format | Example |
|---|---|---|
| Files | | |
| Components | | |
| Hooks | | |
| Functions | | |
| Constants | | |
| Types | | |
| Interfaces | | |
git checkout -b feature/my-feature # make changes pnpm check-types && pnpm lint git commit -m "feat: description" git push origin feature/my-feature # open PR on GitHub
cd apps/bridge pnpm tauri:dev # Hot reload dev mode # Test API: curl http://localhost:9990/api/stats
pnpm ui # Interactive selector # Components added to: packages/ui/components/
# From any app curl -X GET http://localhost:9990/api/status # WebSocket websocat ws://localhost:9990/api/ws
git tag bridge-v1.0.0 # Stable release # or git tag bridge-v1.0.0-beta.1 # Beta release git push origin bridge-v1.0.0 # GitHub Actions automatically builds, signs, and publishes