Skip to content

Home

Jump to bottom
Richard George Davis edited this page Mar 21, 2026 · 4 revisions

Codex Workspace

Codex Workspace is a local-first structure for managing many standalone repositories on one machine without forcing them into a monorepo.

This wiki is a lightweight navigation layer. The canonical documentation lives in the repository itself:

What This Repo Is For

Codex Workspace exists to keep local development practical when your machine contains many unrelated repos.

It combines:

  • a predictable folder layout for mixed stacks
  • shared caches and helper tooling
  • lightweight workspace metadata
  • a filesystem-first documentation and context model
  • a practical Workspace Hub app for discovery, runtime control, and previews

Core Principles

  • Do not merge unrelated repos into one dependency structure.
  • Share caches, not installs.
  • Treat each repo as independently runnable.
  • Do not make ServBay mandatory.
  • Prefer direct local runtime for frontend and dev-server projects.
  • Keep WordPress handling pragmatic.
  • Use lightweight manifests where explicit runtime behavior helps.

Expected Workspace Layout

Codex Workspace/
├── docs/
├── repos/
├── tools/
├── cache/
├── shared/
└── workspace.code-workspace

Start Here

If you're new to the project, begin with:

  1. README
  2. Docs index
  3. Overview
  4. Workspace handover

Workspace Hub

Workspace Hub is the most concrete product in this repo today. It scans sibling repos, classifies them conservatively, shows runtime and metadata state, and provides start, stop, open, and preview actions without forcing all repos into one toolchain.

Read more:

Runtime Model

Typical defaults:

  • WordPress: usually external
  • Vite / static / Three.js / WebGL: usually direct
  • Other server-side repos: use the repo-native runtime, optionally proxied when that adds clear value

The goal is practical local operation, not one enforced runtime model.

Metadata And Manifests

Where explicit runtime behavior helps, use lightweight metadata such as .workspace/project.json.

Related docs:

Community

Canonical Docs

This wiki should stay short and navigational.

Detailed and durable project documentation belongs in the tracked repo under docs/, README.md, and repo-local docs such as repos/workspace-hub/docs/.

Clone this wiki locally