CodeMesh
CodeMesh is a local-first developer workspace fabric for Git projects, machines, and coding agents.
It keeps the canonical project tree visible, checks whether projects are present and ready, prepares temporary agent workspaces, and records local handoff metadata without replacing Git or storing secret values.
#Start Here
- Install: build the current CLI from source and verify it runs.
- Quickstart: try CodeMesh against a local Git remote with isolated state.
- Command Catalog: see the current runnable command surface.
- Command references: init, add, scan, tree, status, doctor, hydrate, access, manifest export, manifest import, agent prepare, runs, and clean.
- Trust Boundaries: review what CodeMesh does and does not own.
- Local State Model: understand CodeMesh home, SQLite metadata, and agent run storage.
#What It Does
- Tracks a Project Registry for the intended workspace tree.
- Shows present, missing, dirty, stale, and env-missing readiness signals.
- Hydrates registered missing projects through explicit Git clones and command-triggered access.
- Exports and imports portable workspace manifests while keeping SQLite local.
- Prepares temporary agent workspaces from clean Git bases.
- Checks env readiness by names and paths only.
- Reports declared toolchain readiness without installing or building environments.
#What It Does Not Do
CodeMesh does not replace Git, sync arbitrary files, become a cloud drive, create daemon or mount behavior, hydrate on filesystem path access, create automatic placeholders, store raw secrets, materialize secret values, or install/build toolchains in the MVP.
#Current Shape
| Area | Current MVP stance |
|---|---|
| Project Registry | Local SQLite metadata and Git remote identity. |
| Workspace Manifest | Portable JSON topology exported from and imported into local SQLite. |
| Readiness | Warnings and blockers derived from the local filesystem and Git state. |
| Doctor | Agent handoff preflight without creating run state. |
| Agent Prep | Temporary clone, selected base, policy check, and run metadata. |
| Env Readiness and Binding | Missing file/key detection plus fake-provider bundle proof without live secret providers. |
| Toolchain Readiness | Policy-declared status reporting and delegation only. |
#Source
CodeMesh is open source at BramVR/codemesh.