Home

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:

• README
• Docs index

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