Skip to content

feat(desktop): import ui-desktop, the ClawCodex Desktop app shell (stage 1) - #802

Merged
agentforce314 merged 1 commit into
mainfrom
feat/desktop-source-import
Aug 8, 2026
Merged

feat(desktop): import ui-desktop, the ClawCodex Desktop app shell (stage 1)#802
agentforce314 merged 1 commit into
mainfrom
feat/desktop-source-import

Conversation

@agentforce314

Copy link
Copy Markdown
Owner

Summary

Stage 1 of the ClawCodex Desktop port: imports the desktop app from the reference implementation into ui-desktop/ as a standalone npm project, fully rebranded for ClawCodex.

  • Electron + Vite + React renderer, main process, Playwright e2e specs, build/packaging scripts, and the shared types package vendored at ui-desktop/packages/shared (@clawcodex/shared) — mirroring the ui-tui/packages convention.
  • Identity map applied throughout: product/app names, com.clawcodex.desktop appId, clawcodex:// deep-link scheme, CLAWCODEX_* env surface (profile dir → CLAWCODEX_CONFIG_DIR), config paths, i18n strings in all 5 locales, installer metadata.
  • New ClawCodex claw-mark icon set (icns/ico/png) + brand mark; upstream mascot art dropped (unreferenced) or replaced.
  • Self-contained build: local node_modules resolution (vite aliases, fs.allow, electron-rebuild, root-install assert), vendored shared eslint flat config, lint toolchain as exact-pinned devDeps, fresh committed package-lock.json.
  • Quarantine over deletion (TUI port precedent): cloud-portal/billing surfaces compile but point at an inert portal.invalid base.

Gates (measured against the reference on the same machine)

Gate Result
typecheck (renderer + electron + e2e) ✅ green — matches reference
eslint ✅ 0 errors / 88 warnings — identical to reference
vitest ✅ 4,249 passed / 274 failed / 38 failing files — failure set byte-identical to the reference baseline (pre-existing upstream failures)

Scope

No wiring claims: the app still targets the reference backend contract under renamed identifiers. Stage 2 re-plumbs boot + chat onto clawcodex serve (HTTP + JSON-RPC WS over the existing agent-server core).

🤖 Generated with Claude Code

…age 1)

Ports the desktop app from the reference implementation into ui-desktop/ as a
standalone npm project, fully rebranded for ClawCodex:

- Electron + Vite + React renderer, main process, e2e specs, build scripts,
  and the shared types package vendored at ui-desktop/packages/shared
  (@clawcodex/shared), mirroring the ui-tui/packages convention.
- Identity map applied throughout: product/app names, com.clawcodex.desktop
  appId, clawcodex:// deep-link scheme, CLAWCODEX_* env surface (profile dir
  maps to CLAWCODEX_CONFIG_DIR), config paths, i18n strings across all 5
  locales, installer metadata.
- New ClawCodex claw-mark icon set (icns/ico/png) and brand mark; upstream
  mascot art dropped (unreferenced) or replaced.
- Self-contained build: local node_modules resolution (vite aliases, fs.allow,
  electron-rebuild, root-install assert), vendored shared eslint flat config,
  lint toolchain as exact-pinned devDeps, fresh committed package-lock.json.
- Cloud-portal/billing surfaces kept compiling but quarantined behind an inert
  portal.invalid base URL, following the TUI port precedent.

Gates measured against the reference on the same machine:
- typecheck (renderer + electron + e2e tsconfigs): green, matches reference
- eslint: 0 errors / 88 warnings, identical to reference
- vitest: 4,249 passed / 274 failed / 38 failing files - failure set is
  byte-identical to the reference baseline (pre-existing upstream failures)

Backend wiring (clawcodex serve + boot ladder) is stage 2; this stage makes no
wiring claims - the app still targets the reference backend contract under
renamed identifiers.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@agentforce314
agentforce314 merged commit b49711d into main Aug 8, 2026
3 checks passed
@agentforce314 agentforce314 mentioned this pull request Aug 8, 2026
agentforce314 added a commit that referenced this pull request Aug 8, 2026
ClawCodex Desktop headlines 1.5.0: the native app (ui-desktop/), the
clawcodex serve gateway backing it, the clawcodex desktop launcher, official
crab branding, and macOS packaging — plus the ship-week fixes (lib/
tracking, 100% default UI scale, already-running launch guard).

- version 1.4.0 -> 1.5.0 (pyproject + src/__init__ fallback)
- CHANGELOG: cut [1.5.0] from Unreleased (#802-#808)
- News: v1.5.0 item in README (v0.6.0 rotated to docs/NEWS.md archive)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant