Try it!

// Desktop

PasClaw Desktop

PasClaw Desktop replaces the chat log with windows, icons, a taskbar and virtual desktops. Ask it to handle your email and the deliverable is a small app running in a window, not an essay about how you might build one.

Window managerWorkspacesApp factory27 retro styles
01

Two frontends over one backend

The gateway serves a single-file web UI at /desktop with a window manager, project dock and a taskbar workspace pager, and a FireMonkey app lives in desktop/ built on Cross-Platform-Retro-OS-Styles. The window manager and styles are vendored so the project builds and runs from a plain checkout.

02

Workspace, project, task, job

A workspace is a separate agent world; a project is a thing being built; a task is a unit of intent; a job is one agent run working a task. Everything is a JSON manifest on disk that the agent edits through project and task tools — greppable, syncable, no database.

03

An app factory

Apps come in page, html, python, fpc and delphi kinds with a per-app state store, sandbox and CSP containment, and blueprint export that carries the software but never the data. Process apps are built and spawned by a runner that shows the command first and refuses to start without explicit per-run consent.

04

Structured output as period furniture

A plan arrives as a Win95-style wizard whose Finish button turns its steps into real tasks; a decision arrives as a message box with buttons. Each of the 27 styles carries its own voice, and answer pages render search as an HTML document whose sources PasClaw writes itself.

From the documentation

Technical details

Implementation notes drawn from the PasClaw repository documentation.

Quick start

Run the gateway, seed the system suite, then open the desktop in a browser. The full agent chat and configuration surface is still at / and opens inside the desktop as a window via Menu → Agent Console.

pasclaw gateway                 # http://127.0.0.1:8088
pasclaw project seed            # install the system suite
pasclaw mail sync               # optional: fill Mail from IMAP

Workspaces are walls

Memory, sessions, skills, the knowledgebase, checkpoints, cron state, projects, pages and the desktop layout are all per-workspace, and isolation tests pin the behaviour.

  • The original workspace/ directory is workspace #1; nothing moved when this landed.
  • pasclaw workspace new / use manage siblings; $PASCLAW_WORKSPACE overrides one process.
  • pasclaw workspace bind <workspace> <profile> applies per-business providers, keys and sandbox settings.
  • One gateway serves one active workspace at a time; run two gateways for concurrent worlds.

Live board updates

/v1/desktop/events pushes board changes over SSE, so the window manager, project dock and task board reflect agent progress without polling.

  • The taskbar pager switches numbered desktops with Ctrl+Alt+arrow keys.
  • Each desktop keeps its own window layout, saved on the gateway.
  • Switching workspaces sits behind a confirmation because it changes what PasClaw remembers.

A remakeable starter suite

pasclaw project seed installs Notes, To Do, Brain, Calendar, Library, Cookbook and Mail — ordinary projects the agent can rebuild or replace like any other.

Source documentation

desktop.md desktop-plan.md workspaces-plan.md

Common questions

Frequently asked questions

Keep exploring

See how the rest of PasClaw fits together.

Hashline edits