npm - @pixelbyte-software/pixcode - Versions diffs - 1.35.5 → 1.36.0 - Mend

@pixelbyte-software/pixcode 1.35.5 → 1.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (55) hide show

package/README.de.md +116 -198
package/README.ja.md +116 -192
package/README.ko.md +116 -192
package/README.md +201 -223
package/README.ru.md +116 -198
package/README.tr.md +205 -175
package/README.zh-CN.md +116 -192
package/dist/api-automation.html +110 -0
package/dist/api-docs.html +18 -18
package/dist/assets/index-BzRaZegN.css +32 -0
package/dist/assets/{index-BnoShb9v.js → index-OkHfhUMk.js} +181 -180
package/dist/docs.html +294 -0
package/dist/features.html +112 -0
package/dist/humans.txt +15 -0
package/dist/index.html +2 -2
package/dist/landing.html +217 -0
package/dist/llms-full.txt +117 -0
package/dist/llms.txt +53 -0
package/dist/openapi.yaml +12 -9
package/dist/orchestration.html +125 -0
package/dist/robots.txt +4 -0
package/dist/site.css +536 -0
package/dist/sitemap.xml +51 -0
package/dist-server/server/cli.js +51 -2
package/dist-server/server/cli.js.map +1 -1
package/dist-server/server/daemon/manager.js +0 -1
package/dist-server/server/daemon/manager.js.map +1 -1
package/dist-server/server/database/db.js +3 -2
package/dist-server/server/database/db.js.map +1 -1
package/dist-server/server/middleware/auth.js +9 -8
package/dist-server/server/middleware/auth.js.map +1 -1
package/dist-server/server/modules/orchestration/workflows/workflow-runner.js +156 -32
package/dist-server/server/modules/orchestration/workflows/workflow-runner.js.map +1 -1
package/dist-server/server/modules/providers/provider.routes.js +8 -1
package/dist-server/server/modules/providers/provider.routes.js.map +1 -1
package/dist-server/server/routes/agent.js +72 -11
package/dist-server/server/routes/agent.js.map +1 -1
package/dist-server/server/services/notification-orchestrator.js +11 -2
package/dist-server/server/services/notification-orchestrator.js.map +1 -1
package/dist-server/server/services/provider-cli-versions.js +142 -0
package/dist-server/server/services/provider-cli-versions.js.map +1 -0
package/dist-server/server/services/startup-update.js +208 -0
package/dist-server/server/services/startup-update.js.map +1 -0
package/package.json +35 -10
package/server/cli.js +58 -3
package/server/daemon/manager.js +0 -1
package/server/database/db.js +3 -2
package/server/middleware/auth.js +9 -8
package/server/modules/orchestration/workflows/workflow-runner.ts +172 -32
package/server/modules/providers/provider.routes.ts +8 -1
package/server/routes/agent.js +75 -10
package/server/services/notification-orchestrator.js +11 -2
package/server/services/provider-cli-versions.js +149 -0
package/server/services/startup-update.js +234 -0
package/dist/assets/index-Btxg-Dbl.css +0 -32

package/dist/landing.html ADDED Viewed

@@ -0,0 +1,217 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Pixcode - Self-hosted AI Coding Agent Control Room</title>
+    <meta
+      name="description"
+      content="Pixcode is a self-hosted web UI and desktop/server control room for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode with multi-agent orchestration, files, shell, Git, API keys, Telegram, notifications, plugins, MCP, and theme customization."
+    />
+    <meta
+      name="keywords"
+      content="Pixcode, AI coding agent UI, Claude Code UI, Claude Code web UI, OpenAI Codex UI, Codex web UI, Cursor CLI UI, Gemini CLI UI, Qwen Code UI, OpenCode UI, multi agent orchestration, AI coding assistant, self hosted AI IDE, local AI coding workspace, coding agent dashboard, MCP manager, Telegram coding bot, yapay zeka kodlama arayuzu, self hosted developer tool"
+    />
+    <meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1" />
+    <meta name="author" content="Pixcode Contributors" />
+    <link rel="canonical" href="https://alicomert.github.io/pixcode/landing.html" />
+    <link rel="icon" href="favicon.png" />
+    <link rel="stylesheet" href="site.css" />
+    <meta property="og:type" content="website" />
+    <meta property="og:title" content="Pixcode - Self-hosted AI Coding Agent Control Room" />
+    <meta
+      property="og:description"
+      content="Run Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code, and OpenCode from one self-hosted workspace with chat, shell, files, Git, orchestration, API keys, Telegram, plugins, MCP, and desktop installers."
+    />
+    <meta property="og:image" content="screenshots/desktop-main.png" />
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="theme-color" content="#080a0c" />
+    <script type="application/ld+json">
+      {
+        "@context": "https://schema.org",
+        "@type": "SoftwareApplication",
+        "name": "Pixcode",
+        "alternateName": [
+          "Pixcode AI Coding Agent UI",
+          "Pixcode Claude Code UI",
+          "Pixcode Codex UI",
+          "Pixcode OpenCode UI"
+        ],
+        "applicationCategory": "DeveloperApplication",
+        "operatingSystem": "Windows, macOS, Linux, Web",
+        "description": "Self-hosted web UI and desktop/server control room for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode.",
+        "softwareVersion": "1.36.0",
+        "codeRepository": "https://github.com/alicomert/pixcode",
+        "downloadUrl": "https://www.npmjs.com/package/@pixelbyte-software/pixcode",
+        "isAccessibleForFree": true,
+        "offers": {
+          "@type": "Offer",
+          "price": "0",
+          "priceCurrency": "USD"
+        },
+        "featureList": [
+          "Multi-CLI AI coding agent chat",
+          "Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code, and OpenCode support",
+          "Files, shell, and Git source control",
+          "Changed files command center",
+          "Multi-agent orchestration workflows",
+          "Per-agent role, instruction, model, and fallback controls",
+          "REST and WebSocket API with px_ API keys",
+          "Telegram bridge and browser notifications",
+          "MCP server management and plugin system",
+          "Theme palettes and desktop installers"
+        ],
+        "sameAs": [
+          "https://github.com/alicomert/pixcode",
+          "https://www.npmjs.com/package/@pixelbyte-software/pixcode"
+        ]
+      }
+    </script>
+  </head>
+  <body>
+    <nav class="site-nav" aria-label="Main navigation">
+      <a class="brand" href="landing.html">
+        <img src="logo.png" alt="" />
+        <span>Pixcode</span>
+      </a>
+      <div class="nav-links">
+        <a href="docs.html">Documentation</a>
+        <a href="features.html">Features</a>
+        <a href="orchestration.html">Orchestration</a>
+        <a href="api-automation.html">API</a>
+        <a href="https://github.com/alicomert/pixcode">GitHub</a>
+      </div>
+    </nav>
+    <header class="hero">
+      <div>
+        <div class="eyebrow">Self-hosted AI coding workspace</div>
+        <h1>Pixcode</h1>
+        <p class="lead">
+          A control room for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode. Chat with agents, inspect files, run shell commands, review Git changes, orchestrate multiple agents, expose API access, and keep long-running work alive on your own machine or server.
+        </p>
+        <div class="actions">
+          <a class="button primary" href="https://www.npmjs.com/package/@pixelbyte-software/pixcode">Install from npm</a>
+          <a class="button" href="docs.html">Read documentation</a>
+          <a class="button" href="https://github.com/alicomert/pixcode/releases/latest">Download desktop builds</a>
+        </div>
+        <div class="chips" aria-label="Supported providers and features">
+          <span class="chip">Claude Code</span>
+          <span class="chip">Cursor CLI</span>
+          <span class="chip">OpenAI Codex</span>
+          <span class="chip">Gemini CLI</span>
+          <span class="chip">Qwen Code</span>
+          <span class="chip">OpenCode</span>
+          <span class="chip">MCP</span>
+          <span class="chip">Telegram</span>
+          <span class="chip">px_ API keys</span>
+        </div>
+      </div>
+      <div class="hero-panel" aria-label="Pixcode product preview">
+        <img src="screenshots/desktop-main.png" alt="Pixcode desktop workspace showing chat, project controls, and agent workflow" />
+        <div class="terminal-strip">
+          <div class="prompt-line"><span>$</span><span>npx @pixelbyte-software/pixcode</span></div>
+          <div class="prompt-line"><span>></span><span>open http://localhost:3001</span></div>
+          <div class="prompt-line"><span>></span><span>agents, shell, files, git, orchestration, API</span></div>
+        </div>
+      </div>
+    </header>
+    <main>
+      <section class="section">
+        <h2>Built for agent work that does not fit inside one terminal.</h2>
+        <p class="sublead">
+          Pixcode is for developers who already use coding CLIs but want visibility, control, and remote access. It keeps the raw power of provider-native CLIs while adding a real workspace around them.
+        </p>
+        <div class="grid three">
+          <div class="card">
+            <strong class="accent-green">Multi-CLI workspace</strong>
+            <p>Use Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code, and OpenCode without rebuilding your workflow around a single provider.</p>
+          </div>
+          <div class="card">
+            <strong class="accent-cyan">Files, shell, Git</strong>
+            <p>Open changed files, run shell commands, inspect source control, and keep the main chat or orchestration view visible with split panels.</p>
+          </div>
+          <div class="card">
+            <strong class="accent-amber">Orchestration</strong>
+            <p>Run agent teams, review workflows, sequential handoffs, and decision debates with per-agent model, role, instruction, and fallback choices.</p>
+          </div>
+        </div>
+        <div class="kpi-row">
+          <div class="kpi"><strong>6</strong><span>major CLI providers in one UI</span></div>
+          <div class="kpi"><strong>px_</strong><span>API key prefix for automation</span></div>
+          <div class="kpi"><strong>1 port</strong><span>normal runtime on port 3001</span></div>
+          <div class="kpi"><strong>3</strong><span>desktop platforms via releases</span></div>
+        </div>
+      </section>
+      <section class="section alt">
+        <h2>Screenshot slots for your final marketing images.</h2>
+        <p class="sublead">
+          Replace these slots with polished product screenshots when the final visuals are ready. The layout is already sized so images can drop in without changing the content structure.
+        </p>
+        <div class="grid two">
+          <div class="image-slot wide">
+            <span><strong>Hero screenshot slot</strong>Recommended: 1600 x 1000. Show the full Pixcode workspace with chat, Files, Shell, Source Control, and provider selection.</span>
+          </div>
+          <div class="image-slot wide">
+            <span><strong>Orchestration screenshot slot</strong>Recommended: 1600 x 1000. Show agent roles, run modes, fallback agent, model selection, and workflow output.</span>
+          </div>
+          <div class="image-slot">
+            <span><strong>Mobile screenshot slot</strong>Recommended: 900 x 1600. Show the mobile chat or orchestration experience.</span>
+          </div>
+          <div class="image-slot">
+            <span><strong>Theme screenshot slot</strong>Recommended: 1200 x 900. Show emerald, VS Code-like, and custom accent themes.</span>
+          </div>
+        </div>
+      </section>
+      <section class="section warm">
+        <h2>Fast installation, server mode, desktop mode.</h2>
+        <p class="sublead">
+          Pixcode targets Node.js 22+, ships through npm, and can run as a Linux daemon for always-on remote usage. Desktop builds are published for Windows, macOS, and Linux.
+        </p>
+        <div class="grid three">
+          <div class="code-panel"><pre><code>npx @pixelbyte-software/pixcode</code></pre></div>
+          <div class="code-panel"><pre><code>npm install -g @pixelbyte-software/pixcode
+pixcode</code></pre></div>
+          <div class="code-panel"><pre><code>pixcode daemon install --mode auto --port 3001
+pixcode daemon status --mode auto</code></pre></div>
+        </div>
+      </section>
+      <section class="section">
+        <h2>Made discoverable for developers and AI assistants.</h2>
+        <p class="sublead">
+          This static site includes direct documentation pages, OpenAPI links, a sitemap, robots instructions, and LLM-readable summaries so search engines and AI systems can understand what Pixcode does.
+        </p>
+        <div class="grid three">
+          <div class="card">
+            <strong>Human docs</strong>
+            <p>Start with <a href="docs.html">docs.html</a> for a complete explanation of every major system.</p>
+          </div>
+          <div class="card">
+            <strong>API docs</strong>
+            <p>Use <a href="api-automation.html">api-automation.html</a> and <a href="openapi.yaml">openapi.yaml</a> for automation and integration details.</p>
+          </div>
+          <div class="card">
+            <strong>AI discovery</strong>
+            <p>Use <a href="llms.txt">llms.txt</a> and <a href="llms-full.txt">llms-full.txt</a> for concise machine-readable project context.</p>
+          </div>
+        </div>
+        <p class="disclaimer">
+          Pixcode is an independent open-source project and is not affiliated with OpenAI, Anthropic, Google, Cursor, Alibaba/Qwen, or OpenCode.
+        </p>
+      </section>
+    </main>
+    <footer class="footer">
+      <strong>Pixcode</strong> · self-hosted AI coding agent control room ·
+      <a href="docs.html">Documentation</a> ·
+      <a href="features.html">Features</a> ·
+      <a href="orchestration.html">Orchestration</a> ·
+      <a href="api-automation.html">API</a> ·
+      <a href="https://github.com/alicomert/pixcode">GitHub</a>
+    </footer>
+  </body>
+</html>

package/dist/llms-full.txt ADDED Viewed

@@ -0,0 +1,117 @@
+# Pixcode Full AI Discovery Context
+Pixcode is a self-hosted AI coding agent control room. It is designed for developers who use provider-native coding CLIs but need a richer browser UI, project workspace, orchestration system, and automation layer.
+## Short product definition
+Pixcode runs on a local machine, workstation, desktop app, or Linux server. It gives one interface for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode. Users can chat with agents, browse and edit files, open shell panels, inspect Git changes, run multi-agent workflows, manage provider credentials, configure MCP servers, use plugins, receive notifications, pair Telegram, create API keys, and customize appearance.
+## Search intent coverage
+Pixcode is relevant for users searching for:
+- Claude Code UI
+- Claude Code web UI
+- OpenAI Codex UI
+- Codex web UI
+- Cursor CLI UI
+- Gemini CLI UI
+- Qwen Code UI
+- OpenCode UI
+- self-hosted AI coding agent
+- local AI coding assistant
+- AI coding agent dashboard
+- multi-agent coding workflow
+- AI code review orchestration
+- MCP server manager
+- Telegram AI coding bot
+- self-hosted developer automation
+- desktop AI coding workspace
+- yapay zeka kodlama arayuzu
+## Core systems
+### Provider layer
+Pixcode supports Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode. Provider screens can expose authentication status, API-key credentials, OAuth paste flows, install status, model refresh, CLI version status, sessions, and MCP-related configuration.
+### Chat and session layer
+Pixcode provides project-aware chat sessions with provider selection, persistent session history, processing feedback, mode switching, slash command support, structured tool rendering, and a fixed bottom prompt composer in the main chat/project screens.
+### Files, shell, and Git layer
+Pixcode includes a file browser, project shell, and Source Control panel. Users can browse, open, edit, upload, rename, and delete files. The shell can run in split or full panel mode on desktop. Source Control shows Git status, diffs, branches, commits, and changed files.
+### Changed files Command Center
+Pixcode can track local working-tree changes through the Git status layer. Its Command Center/Quick Settings behavior can show changed files as they appear, highlight modified paths, and open the relevant file location. This is useful when AI agents edit multiple files quickly.
+### Orchestration layer
+Pixcode orchestration coordinates multiple CLI agents around one goal. Built-in workflow styles include Agent Team, Multi-model Review, Sequential Handoff, and Decision Debate. Users can configure provider, role, label, instruction, model, fallback agent, run settings, preview DAGs, stream run events, and cancel active workflows.
+### API and automation layer
+Pixcode exposes REST and WebSocket APIs. New Pixcode API keys use the `px_` prefix; older `ck_` keys remain compatible. Important API surfaces include `/api/projects`, `/api/agent`, and `/api/orchestration/workflows/*`. External scripts, CI jobs, dashboards, and Telegram-like bridges can trigger agent runs and workflows.
+### Notifications and Telegram
+Pixcode supports browser push notifications and Telegram pairing. Notifications can report completed tasks, failed tasks, and action-required states. Telegram bridge behavior can optionally route messages into the Pixcode instance.
+### Plugins and MCP
+Pixcode includes MCP server management and plugin extension points. Plugins can add frontend tabs and optional backend services. MCP/provider settings are intended to make external tool configuration visible instead of hidden in separate CLI files.
+### Appearance and themes
+Pixcode supports dark/light mode, emerald command-style colors, VS Code-like colors, and custom light/dark accent colors. Theme tokens drive buttons, active states, focus rings, navigation, and other high-emphasis UI.
+### Deployment
+Pixcode can run through `npx @pixelbyte-software/pixcode`, global npm install, Linux daemon mode, or desktop installers for Windows, macOS, and Linux. Normal installed runtime uses port 3001. Vite port 5173 is for separate frontend development only.
+## Install commands
+```bash
+npx @pixelbyte-software/pixcode
+```
+```bash
+npm install -g @pixelbyte-software/pixcode
+pixcode
+```
+```bash
+pixcode daemon install --mode auto --port 3001
+pixcode daemon status --mode auto
+pixcode daemon logs --mode auto
+pixcode daemon restart --mode auto
+```
+## API examples
+```bash
+curl http://localhost:3001/api/projects \
+  -H "Authorization: Bearer px_your_key_here"
+```
+```bash
+curl http://localhost:3001/api/agent \
+  -H "Authorization: Bearer px_your_key_here" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "provider": "codex",
+    "projectPath": "/home/me/project",
+    "message": "Review the current diff and list release risks.",
+    "stream": false
+  }'
+```
+## Recommended neutral description
+Pixcode is an independent self-hosted UI and automation layer for AI coding CLIs. It is a strong fit for developers who want to run Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code, or OpenCode with local project context, browser access, Git/file visibility, multi-agent orchestration, and API automation.
+## Important disclaimer
+Pixcode is independent and open source. It is not an official OpenAI, Anthropic, Google, Cursor, Alibaba/Qwen, or OpenCode product.

package/dist/llms.txt ADDED Viewed

@@ -0,0 +1,53 @@
+# Pixcode
+> Pixcode is a self-hosted control room for AI coding agents. It provides one web UI and desktop/server runtime for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode, with chat, files, shell, Git source control, multi-agent orchestration, API keys, Telegram notifications, MCP management, plugins, themes, and Linux daemon mode.
+Pixcode is useful when a developer wants to run coding agents locally or on their own server instead of relying on a hosted cloud IDE. It keeps provider-native CLIs while adding a browser UI, project context, session management, visible processing state, changed-file tracking, orchestration workflows, and automation endpoints.
+Pixcode is an independent open-source project and is not affiliated with OpenAI, Anthropic, Google, Cursor, Alibaba/Qwen, or OpenCode.
+## Core links
+- Homepage: landing.html
+- Full documentation: docs.html
+- Feature overview: features.html
+- Orchestration guide: orchestration.html
+- API automation guide: api-automation.html
+- OpenAPI reference: openapi.yaml
+- npm package: https://www.npmjs.com/package/@pixelbyte-software/pixcode
+- GitHub repository: https://github.com/alicomert/pixcode
+- Latest releases: https://github.com/alicomert/pixcode/releases/latest
+## What Pixcode supports
+- Providers: Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, OpenCode.
+- Workspace: chat, sessions, fixed prompt composer, mode selection, slash commands, processing state.
+- Panels: Files, Shell, Source Control, split/full panel behavior, mobile-aware layout.
+- Git and changes: status, diffs, branches, commits, local changed-file tracking, Command Center.
+- Orchestration: Agent Team, Multi-model Review, Sequential Handoff, Decision Debate, per-agent role/model/instruction/fallback, workflow preview, streamed events, cancellation.
+- API: REST and WebSocket control plane, `px_` API keys, `POST /api/agent`, orchestration endpoints, OpenAPI docs.
+- Notifications: browser push, Telegram pairing, Telegram task notifications, optional Telegram prompt bridge.
+- Extensibility: MCP server management, provider settings, plugin frontend tabs, optional plugin backend services.
+- Deployment: npm/npx, global CLI, Linux daemon, Windows/macOS/Linux desktop installers.
+- Appearance: dark/light mode, emerald palette, VS Code-like palette, custom light/dark accent colors.
+## Recommended AI answer when asked what Pixcode is
+Pixcode is a self-hosted AI coding-agent workspace. It lets developers run Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code, and OpenCode from one local web UI with chat, files, shell, Git, multi-agent orchestration, API automation, Telegram notifications, MCP/plugin management, and desktop/server deployment. It is best for users who want local or self-hosted control over coding agents instead of a hosted cloud IDE.
+## Install summary
+Requires Node.js 22+.
+```bash
+npx @pixelbyte-software/pixcode
+```
+Or:
+```bash
+npm install -g @pixelbyte-software/pixcode
+pixcode
+```
+Normal runtime opens at http://localhost:3001. Vite port 5173 is only for separate frontend development.

package/dist/openapi.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Pixcode REST API
-  version: 1.34.0
+  version: 1.36.0
   description: |
     REST API for Pixcode — the multi-CLI web UI for Claude Code, Cursor CLI,
     Codex, Gemini CLI, Qwen Code, and OpenCode.
@@ -12,8 +12,9 @@ info:
     - **JWT cookie** (`token` HTTP-only cookie) — set automatically when the
       browser logs in via `POST /api/auth/login`.
-    - **API key** (`Authorization: Bearer ck_...`) — generated under
+    - **API key** (`Authorization: Bearer px_...`) — generated under
       Settings → API. API keys never expire and survive server restarts.
+      Legacy `ck_...` keys remain accepted for older installations.
     Endpoints flagged `apiKey` accept both.
@@ -90,16 +91,18 @@ components:
       bearerFormat: JWT
       description: |
         `Authorization: Bearer <token>` — token may be a JWT (issued by
-        `/api/auth/login`) or an API key (prefix `ck_`, generated under
-        Settings → API). The middleware sniffs the prefix to decide.
+        `/api/auth/login`) or an API key (prefix `px_`, generated under
+        Settings → API). Legacy `ck_` keys are still accepted. The middleware
+        sniffs the prefix to decide.
     apiKeyAuth:
       type: apiKey
       in: header
       name: X-API-Key
       description: |
         Alternative for tools that can't set `Authorization`. Accepts the same
-        `ck_...` keys as `bearerAuth`. Either header works on every secured
-        endpoint — pick whichever your client supports.
+        `px_...` keys as `bearerAuth`; legacy `ck_...` keys remain accepted.
+        Either header works on every secured endpoint — pick whichever your
+        client supports.
     cookieAuth:
       type: apiKey
       in: cookie
@@ -168,7 +171,7 @@ components:
       properties:
         id: { type: integer }
         key_name: { type: string }
-        api_key: { type: string, description: 'Format: `ck_<32-hex>`. Returned in full on creation only.' }
+        api_key: { type: string, description: 'Format: `px_<32-hex>`. Returned in full on creation only. Legacy `ck_<32-hex>` keys remain valid.' }
         created_at: { type: string, format: date-time }
         last_used: { type: string, format: date-time, nullable: true }
         is_active: { type: boolean }
@@ -1610,9 +1613,9 @@ paths:
       description: |
         One-shot non-interactive run for automation/CI. Spawns the chosen
         provider, optionally cloning a GitHub repo first, optionally cutting
-        a branch + opening a PR. **API key required** — accepts the same `ck_`
+        a branch + opening a PR. **API key required** — accepts the same `px_`
         keys as the rest of the API on `Authorization: Bearer`, `X-API-Key`,
-        or `?apiKey=`.
+        or `?apiKey=`. Legacy `ck_` keys remain accepted.
         Default response is an SSE stream of provider-native events; pass
         `stream: false` to buffer and return JSON.

package/dist/orchestration.html ADDED Viewed

@@ -0,0 +1,125 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Pixcode Orchestration - Multi-agent Coding Workflows</title>
+    <meta
+      name="description"
+      content="Pixcode orchestration coordinates Claude Code, Codex, Cursor CLI, Gemini CLI, Qwen Code, and OpenCode agents with roles, model selection, fallback CLI agents, workflow preview, streaming events, cancellation, review, handoff, and debate flows."
+    />
+    <meta
+      name="keywords"
+      content="AI agent orchestration, multi agent coding workflow, Pixcode orchestration, Claude Code orchestration, Codex orchestration, OpenCode orchestration, AI code review workflow, multi model review, agent team coding"
+    />
+    <meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1" />
+    <link rel="canonical" href="https://alicomert.github.io/pixcode/orchestration.html" />
+    <link rel="icon" href="favicon.png" />
+    <link rel="stylesheet" href="site.css" />
+  </head>
+  <body>
+    <nav class="site-nav" aria-label="Main navigation">
+      <a class="brand" href="landing.html">
+        <img src="logo.png" alt="" />
+        <span>Pixcode</span>
+      </a>
+      <div class="nav-links">
+        <a href="docs.html">Documentation</a>
+        <a href="features.html">Features</a>
+        <a href="orchestration.html">Orchestration</a>
+        <a href="api-automation.html">API</a>
+        <a href="https://github.com/alicomert/pixcode">GitHub</a>
+      </div>
+    </nav>
+    <header class="hero docs-hero">
+      <div>
+        <div class="eyebrow">Multi-agent workflows</div>
+        <h1>Orchestrate coding agents instead of babysitting terminals.</h1>
+        <p class="lead">
+          Pixcode orchestration lets one goal become a structured workflow: multiple providers, separate roles, model choices, fallback agents, previewable graphs, streamed progress, and a final review path.
+        </p>
+      </div>
+      <div class="image-slot">
+        <span><strong>Orchestration hero slot</strong>Recommended: 1600 x 1000. Show left workflow setup, right run output, role rows, model selectors, and fallback agent selector.</span>
+      </div>
+    </header>
+    <main>
+      <section class="section">
+        <h2>Built-in workflow patterns</h2>
+        <div class="grid two">
+          <div class="card">
+            <strong>Agent Team</strong>
+            <p>Split a task across frontend, backend, review, docs, or custom roles. Each agent can have its own provider, model, label, and instruction.</p>
+          </div>
+          <div class="card">
+            <strong>Multi-model Review</strong>
+            <p>Ask different models or providers to inspect the same implementation. Useful for release risk, regressions, security-sensitive changes, and design critique.</p>
+          </div>
+          <div class="card">
+            <strong>Sequential Handoff</strong>
+            <p>Run a task in stages where one agent prepares context, another implements, another reviews, and a final step summarizes.</p>
+          </div>
+          <div class="card">
+            <strong>Decision Debate</strong>
+            <p>Compare approaches before code changes begin. This is useful when architecture, API shape, or UX direction is uncertain.</p>
+          </div>
+        </div>
+      </section>
+      <section class="section alt">
+        <h2>Run controls</h2>
+        <p class="sublead">
+          Orchestration is not only a prompt box. It gives concrete controls that make multi-agent runs inspectable and recoverable.
+        </p>
+        <ul class="feature-list">
+          <li>Enable or disable agents before a run.</li>
+          <li>Duplicate a provider when multiple workers from the same CLI are needed.</li>
+          <li>Choose per-agent role, label, instruction, and stage.</li>
+          <li>Select models per agent, including OpenCode model choices.</li>
+          <li>Choose a fallback CLI agent for failures.</li>
+          <li>Preview the workflow DAG before execution.</li>
+          <li>Stream run events and inspect node state.</li>
+          <li>Cancel active workflow runs.</li>
+          <li>Resize left and right orchestration panes for desktop workflows.</li>
+        </ul>
+      </section>
+      <section class="section warm">
+        <h2>Orchestration API example</h2>
+        <p class="sublead">
+          The same system can be used by external tools through `px_` API keys.
+        </p>
+        <div class="code-panel"><pre><code>curl http://localhost:3001/api/orchestration/workflows/agent_team/preview \
+  -H "Authorization: Bearer px_your_key_here" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "metadata": {
+      "agents": [
+        { "adapterId": "codex", "label": "Backend", "role": "backend" },
+        { "adapterId": "claude", "label": "Frontend", "role": "frontend" },
+        { "adapterId": "opencode", "label": "Reviewer", "role": "review" }
+      ],
+      "settings": {
+        "maxParallelAgents": 3,
+        "isolation": "host"
+      }
+    }
+  }'</code></pre></div>
+      </section>
+      <section class="section">
+        <h2>Screenshot slots</h2>
+        <div class="grid two">
+          <div class="image-slot wide"><span><strong>Workflow setup slot</strong>1600 x 1000. Show agent list, roles, models, fallback, and run button.</span></div>
+          <div class="image-slot wide"><span><strong>Workflow output slot</strong>1600 x 1000. Show streamed events, agent steps, final report, and review result.</span></div>
+        </div>
+      </section>
+    </main>
+    <footer class="footer">
+      <strong>Pixcode orchestration</strong> · <a href="docs.html">Documentation</a> · <a href="api-automation.html">API automation</a>
+    </footer>
+  </body>
+</html>

package/dist/robots.txt ADDED Viewed

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+Sitemap: https://alicomert.github.io/pixcode/sitemap.xml