johnzhaors-bit / pixelcrabs

PixelCrabs 
 Have an idea? Make it real. 
 An open-source, local-first visual AI development workspace built on OpenCode.
 Describe an app, preview the real result, point at what should change, and keep iterating in actual source code.
 Website ·
 Release notes ·
 简体中文 
> This is the new canonical open-source repository for PixelCrabs. It contains the reviewed Web-first source snapshot. For a ready-to-use desktop build, visit the official website.
## Why PixelCrabs?
Most AI coding tools understand files. PixelCrabs also helps you work from the running interface:
- **Build with an established agent core** — OpenCode provides sessions, models, tools, permissions and source changes.
- **Preview the real project** — work against the application's actual development runtime instead of a disposable mockup.
- **Point, box-select and multi-select** — turn visible UI feedback into structured evidence for the same coding agent.
- **Keep projects local** — your source remains in your own project directory and stays usable with normal developer tools.
- **Choose your models** — use supported providers, your own API keys or compatible local and enterprise endpoints.
- **Extend the workflow** — add Skills, MCP servers and focused tools without creating a second agent engine.
## How it works
 [code] 
## Open-source scope
The public edition is Web-first. It is intended for studying, modifying and running the local development workflow yourself.
| Area | Public direction |
| --- | --- |
| Coding engine | Pinned OpenCode source with upstream licenses and attribution |
| Web projects | Discovery, local development runtime, preview and visual feedback |
| Models | User-configured providers, API keys and compatible local services |
| Skills and tools | Local Skills, MCP and reviewed extension interfaces |
| Delivery | Local build and export through your own tools and hosting |
| Flutter | Planned after the Web workflow is stable |
The hosted PixelCrabs account system, platform model credentials and billing, cloud hosting, marketplace operations, private administration services, commercial resources and dedicated publishing integrations are not part of this repository.
## Repository status
The repository has restarted with a clean public history. Its reviewed source snapshot is derived from the final public commit of the legacy repository and includes:
- a pinned OpenCode engine snapshot under `upstream/opencode`;
- the local Web runtime, preview gateway and static export foundation under `packages/local-runtime`;
- the generic desktop system-network bridge under `packages/platform-desktop`;
- public tests and a Linux smoke workflow.
The ready-to-use commercial desktop app remains a separate distribution. This repository is the source-first public edition and does not contain PixelCrabs platform services.
## Quick start
To preview a trusted static site with **Node.js 24 or later**, run this from the repository root:
 [code] 
The selected directory must contain `index.