← all repositories
rcarmo/piclaw

Your coding agent's persistent, browser-based bunker

PiClaw wraps the Pi Coding Agent in a self-hosted web workspace so you can run a stateful AI locally without stitching together half a dozen services.

799 stars TypeScript Coding AssistantsAgents
piclaw
Not currently ranked — collecting fresh signals.
star history

What it does PiClaw is a single-user, browser-based wrapper around the Pi Coding Agent. It bundles chat, code editing, a terminal, file viewers, VNC, and browser automation into one streaming web UI backed by SQLite. Everything persists in mounted volumes—chat history, media, tasks, token usage, and an encrypted keychain—so the agent remembers context across restarts.

The interesting bit Instead of treating the agent as a headless service, PiClaw gives it a literal workspace: a sidebar file explorer, drag-and-drop uploads, draw.io boards, kanban views, and even an embedded xterm.js terminal. It is essentially a desktop environment reconceived as a web app for an LLM.

Key highlights

  • Ships as a single container with canonical volume paths for home state (/config) and projects (/workspace).
  • Built-in viewers and tools cover Office/PDF/CSV files, draw.io, VNC, browser automation, MCP, and optional cross-instance IPC.
  • Web UI streams over SSE, supports passkey/TOTP auth, mobile layouts, and optional WhatsApp integration.
  • SQLite stores messages, media, tasks, and token usage; the README warns that deleting messages.db destroys all state.
  • An experimental Electrobun desktop shell is available if you prefer a native window to a browser tab.

Caveats

  • Windows is a secondary target with different shell process behavior; Unix-like hosts are the primary focus.
  • Several features—the desktop shell, Microsoft 365 extension, and non-Docker install—are explicitly marked experimental.
  • The workspace is strictly single-user, so team-shared deployments are out of scope.

Verdict Developers who want a private, persistent AI workspace in one container will find PiClaw immediately useful. If you need a multi-user SaaS, a headless API-only agent, or a fully supported Windows native experience, look elsewhere.

Frequently asked

What is rcarmo/piclaw?
PiClaw wraps the Pi Coding Agent in a self-hosted web workspace so you can run a stateful AI locally without stitching together half a dozen services.
Is piclaw open source?
Yes — rcarmo/piclaw is open source, released under the MIT license.
What language is piclaw written in?
rcarmo/piclaw is primarily written in TypeScript.
How popular is piclaw?
rcarmo/piclaw has 799 stars on GitHub.
Where can I find piclaw?
rcarmo/piclaw is on GitHub at https://github.com/rcarmo/piclaw.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.