piclaw
pi coding agent in a technicolor web trenchcoat
PiClaw is a self-hosted AI agent workspace that combines the Pi coding agent with a web-based interface for file editing, command execution, and conversation management. Built for single users by default, it provides a browser-based environment where developers can chat with an AI agent, edit files, run terminal commands, and view results—all in one window. Conversations, files, and scheduled tasks persist across sessions, and the workspace supports local or cloud model providers through OpenAI-compatible APIs. It includes support for MCP servers, browser automation, image processing, and extensible skills, making it a complete agent runtime rather than a component.
Key Features
Use Cases
- 01Running a private AI coding assistant with full file system and terminal access
- 02Developing and testing code with an agent that persists context across sessions
- 03Self-hosting an AI workspace on a Raspberry Pi or dedicated container
- 04Automating file manipulation and command execution through conversational chat
- 05Extending agent capabilities with custom MCP servers and skills
- 06Collaborating in experimental family mode for small trusted teams
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
piclaw — FAQ
What is PiClaw?+
PiClaw is a self-hosted AI agent workspace built on the Pi coding agent. It provides a web interface where you can chat with an AI, edit files, run commands, and inspect results, with all conversations and files persisting between sessions.
How do I install PiClaw?+
The recommended installation method is Docker: create directories for home and workspace data, then run the container with mounted volumes. After startup, open localhost:8080, configure your model provider with `/login`, and select a model with `/model` before chatting.
What AI model providers does PiClaw support?+
PiClaw supports any OpenAI-compatible API, including cloud providers and local model servers like llama.cpp. You configure provider credentials through the `/login` chat command after the first startup.
Does PiClaw work with MCP servers?+
Yes, PiClaw includes built-in MCP server support as one of its extensibility features. You can integrate external MCP servers to expand the agent's capabilities.
Is PiClaw free and open source?+
Yes, PiClaw is released under the MIT license and is completely free to use. Container images are published on GitHub Container Registry and source code is available on GitHub.
What are the security considerations for PiClaw?+
PiClaw is designed for single-user or trusted small-group use. The agent runs with the permissions of its process user and can access mounted files and network resources. Always deploy in a dedicated container or VM, enable browser authentication before remote access, and use HTTPS with a reverse proxy.
How do I install piclaw?+
Open the source repository on GitHub and follow its README. piclaw is a agent — MCP Agents Market links you directly to the official repo.
Is piclaw free?+
piclaw is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.