paseo-alignfirst-workspace

Paseo AlignFirst Workspace

Prerequisites

First, you need:

• an existing workspace or worktree with its branch. Follow the usual procedure. If you don't know, do not invent, ask the user.
• the current Paseo project ID (use paseo project ls --json if you don't have it).

Register a worktree as a Paseo workspace

paseo workspace create \
  --isolation=local \
  --project "<project-id>" \
  --path="<absolute-worktree-path>" \
  --title="<branch-name>"

Keep the = characters. Replace the placeholders with the actual values.

Archive a Paseo workspace

Before removing a workspace or worktree, archive the workspace in Paseo: paseo workspace ls --json lists the workspace IDs. Then:

paseo workspace archive <workspace-id>

Archiving keeps a registered worktree on disk. Remove it afterwards through the usual procedure.