Attivo · AI-native tooling · Cursor companion · Local-first mobile
DeckAgent
- Ruolo
- Solo founder / full-stack product — daemon, PWA, extension Cursor, app iOS + Watch
- Periodo
- 2026
Numeri chiave
- Daemon · PWA · Extension · iOS · WatchSurface prodotto
- TestFlightBeta iPhone
- andrea0x.deckagentExtension
- Local-first · QR pairingPostura sicurezza
01 · DeckAgent
Problema
Il coding agentic su Cursor resta legato al desktop: fuori dal Mac non hai visibilità su agent in corso, plan, chat e file del repo, e non puoi accodare il prossimo prompt a Composer senza riaprire il laptop. Le soluzioni ufficiali puntano ad agent in cloud; chi vuole tenere il codice in locale resta senza un telecomando mobile privacy-first.
02 · DeckAgent
Architettura
Monorepo local-first: un daemon Node (Express + WebSocket, bind 127.0.0.1) indicizza workspace Cursor, chat agent, plan/file e coda prompt senza scrivere su `state.vscdb`; una PWA React 19 (Vite + service worker) e un'app Expo (shell nativa + WebView della stessa PWA, Apple Watch, push) consumano lo stesso API surface; un'extension Cursor/VS Code (`andrea0x.deckagent`) fa pairing QR, heartbeat e delivery verso Composer/Agents, con fallback macOS Accessibility quando l'IDE è stale. Accesso remoto via Cloudflare tunnel / Tailscale con auth obbligatoria fuori localhost; pairing a codice monouso a breve TTL.
03 · DeckAgent
Decisioni chiave
- 01
Local-first, non cloud mirror
Il repo resta sulla macchina di fiducia. Il daemon espone solo lettura sandboxata del workspace + una coda prompt; niente sync del codebase su terzi. Tunnel e Tailscale sono opt-in sopra un bind localhost.
- 02
Nessuna mutazione del DB privato di Cursor
Discovery da filesystem e metadati workspace; zero write su `state.vscdb`. La delivery verso Composer passa da clipboard + focus UI (extension) o automation Accessibility, non da reverse-engineering di API private.
- 03
Una PWA, due shell (web + native)
Feature parity tra browser installabile e iOS: l'app Expo è shell (QR, push, Watch, haptics) intorno alla stessa UI React. Evita di mantenere due client feature-complete.
- 04
Dual path di delivery dei prompt
L'extension fa claim/ack della coda via heartbeat (~8s). Se l'IDE è assente o stale, il daemon può consegnare via Agents window su macOS — resilienza senza un unico punto di fallimento.
- 05
Onboarding via Cursor Agent skill
GTM tecnico: un messaggio copy-paste + skill `@deckagent-pairing` avvia bridge e QR. L'utente resta nel flusso agentic che già conosce.
04 · DeckAgent
Risultati
- Daemon · PWA · Extension · iOS · Watch
Surface prodotto
- TestFlight
Beta iPhone
- andrea0x.deckagent
Extension
- Local-first · QR pairing
Postura sicurezza
- Node · React 19 · Expo 57
Stack core
05 · DeckAgent
Tech e pilastri
Tech stack
- TypeScript
- Node.js
- Express
- WebSocket
- SQLite
- React 19
- Vite
- PWA
- VS Code Extension API
- Expo
- React Native
- Apple Watch
- Cloudflare Tunnel
- Playwright
Pillar toccati
- AI Engineering
- Traditional Software Engineering
- Cloud & DevOps
Contatto
Hai un sistema simile da costruire?
Raccontami il contesto in una call di 30 minuti.
hello@andrea0x.me · @andrea0x_eth