Pixelbox is a local AI software workspace: one app where you can switch projects, run agent terminals, and view the running app in-place.

Pixelbox should feel like an AI-native operating surface for software creation:

• Multiple long-running agent sessions, scoped by project.
• Fast switching between projects without losing runtime/session context.
• A full app viewport for what is currently running.
• Tight loop between editing, running, observing logs, and iterating.
• Explicit coordination between "editor" and "runtime" lanes.

1. Session Model
   • Persistent per-project Codex/OpenClaw sessions across app restarts.
   • Stronger session resume and recovery behavior.
2. Guided Startup Flows
   • "Nothing live yet" quick actions:
     • Boot Next.js service
     • Create static HTML page
     • Create static Next.js page
     • Surprise me
3. Agent Coordination
   • Built-in two-lane workflow (editor/runtime) with shared handoff state.
   • Better project-scoped prompts/skills.
4. Runtime Controls
   • Cleaner server lifecycle controls and health status.
   • Better log surfaces and failure diagnostics.
5. Validation
   • Expand Playwright smoke tests for project switching + runtime visibility.
   • Add deterministic e2e checks for session persistence.

• Floating native Ghostty terminal panel.
• Project switcher and per-project runtime config.
• Embedded live app view for local URLs/files.
• Native app runtime support with capture-image previews.
• AI Launch presets for Codex, Claude, Gemini, Hermes, OpenClaw TUI, or a plain terminal.
• In-app agent monitor for active Codex processes.
• Hidden-project restore list and cleaner project action menus.
• Keyboard project switching with Cmd/Ctrl+Shift+ArrowLeft and Cmd/Ctrl+Shift+ArrowRight.
• File-path drag and drop into the terminal.
• Automatic local port reassignment for colliding localhost dev servers.
• Per-project terminal/session continuity behavior.
• Local guidance injection (AGENTS.md) and handoff scaffolding (.pixelbox/handoff.md).

Pixelbox now includes a standalone static landing site in landing/.

• Intended deployment target: Vercel
• Recommended Vercel root directory: landing
• Local preview:

cd landing
python3 -m http.server 4173

• Local URL:

http://127.0.0.1:4173

npm install
npm run dev

• Use the overlay menu to select an existing project.
• Or click New Project to create one.

In Running Page:

• Source: Node/server command for frameworks (Next.js/Vite/etc).
• Set Server command (example: npm run dev).
• Set Server URL (example: http://localhost:3000) if needed.
• Click Save, then Start.

Or:

• Source: HTML file and point to a static file.

Or:

• Source: Native app command for desktop/native flows.
• Set Run command, optional Capture command, and Image file.
• Click Save, then Start.

• Open the terminal panel.
• In AI Launch, choose which agent CLI should auto-start for the selected project, or choose Plain terminal to open the shell without launching one.
• Use Agent Monitor to inspect active Codex processes running on the machine.
• Use project-scoped prompts.
• Keep runtime and editor tasks coordinated via .pixelbox/handoff.md.

Use this prompt in terminal when a project is empty:

You are inside Pixelbox. Create a minimal landing page for this project and make it visible in the app.
If this project has no framework, create static HTML/CSS in a simple structure.
If scripts are needed, ensure npm run dev works non-interactively.
When done, print:
1) changed files
2) exact command to run
3) local URL

# Core test suite
npm test

# Playwright desktop tests
npm run test:pw
npm run test:pw:run

# Codex/OpenClaw targeted flows
npm run test:pw:codex
npm run test:pw:openclaw
npm run test:pw:next

• build.zig: Zero Native app build, Ghostty linkage, packaging, and platform wiring.
• src/main.zig: application entry point and manifest/runtime boot.
• src/runner.zig: desktop orchestration for windows, bridge events, and runtime actions.
• bridge/server.js: local workspace bridge for project state, runtimes, and PTY-backed sessions.
• renderer/: UI shell, terminal panel integration, and runtime controls.
• lib/codexMonitor.js: active Codex process discovery + transcript summarization helpers.
• lib/terminalSession.js: PTY/stdin shell session wrapper.
• lib/terminalManager.js: multi-session terminal lifecycle by project.
• lib/previewRuntimeManager.js: project runtime process supervision + URL detection.