Use

codemesh tree

GitHubEdit page

codemesh tree

#Syntax

codemesh tree [--json]

#Purpose

Print the known canonical workspace from the local Project Registry, including each project's readiness state, canonical path, current-machine presence, and declared local-only paths when policy is available.

Use --json to emit the stable Command Result shape with command, exit_class, diagnostics, and payload.projects. Each project includes alias, workspace_source (canonical or local-only), normalized state, compatibility path and path_present, canonical_path, canonical_path_present, machine_path, machine_path_present, local_only_paths, remote, base, and readiness diagnostics.

#Safe Example

demo="$(mktemp -d)"
export CODEMESH_HOME="$demo/codemesh-home"
workspace="$demo/workspace"
seed="$demo/seed"
remote="$demo/demo.git"

mkdir -p "$workspace" "$seed"
git -C "$seed" init -b main
printf '# demo\n' > "$seed/README.md"
git -C "$seed" add README.md
git -C "$seed" -c user.name='CodeMesh Demo' -c user.email='demo@example.invalid' commit -m 'Initial demo'
git clone --bare "$seed" "$remote"
git clone "$remote" "$workspace/demo-project"

codemesh init "$workspace"
codemesh add "$workspace/demo-project" --alias demo-project
codemesh tree
codemesh tree --json

#Current Limitations

  • Reads local registry state only.
  • Shows missing imported manifest Projects as metadata. Placeholder directories are created only by explicit codemesh bootstrap --placeholders.
  • Does not create directories, mounts, or clones.
  • Does not check remote freshness; use codemesh status for readiness details.

Back to Command Catalog.