Skip to content

n45-ai workspace

Manage a polyrepo workspace and its members. Run from the workspace root (the folder with the coordination .n45/, created by init in Workspace mode).

A workspace groups several repositories (the members) under a single orchestration. These are the commands you use to assemble and maintain that group — the day-to-day of cross-repo features happens through the slash commands (/n45, /n45-feat) in the IDE.

add

Add a member to the workspace.

npx n45-ai@latest workspace add <path|url>
npx n45-ai@latest workspace add --all
  • <path> — a local git repository (e.g. ./frontend)
  • <url> — a git URL to clone into the workspace (e.g. git@github.com:acme/api.git)
  • --all — adopt every unregistered git folder inside the workspace

A member must be a git repository. After registering (or cloning), N45 provisions the member automatically: it creates the member's .n45/ and installs the skills inherited from the workspace's tools.

cd /path/to/your/workspace
npx n45-ai@latest workspace add ./frontend
npx n45-ai@latest workspace add git@github.com:acme/api.git

sync

Reconcile the workspace with disk: clone missing members and adopt unregistered git folders. Also re-provisions any member missing its skills.

npx n45-ai@latest workspace sync

Use it after cloning the workspace onto a new machine, or when a teammate added members you don't have locally yet.

list

List the workspace members.

npx n45-ai@latest workspace list

remove

Deregister a member from the workspace. It does not delete the member's repository — it just removes it from the orchestration.

npx n45-ai@latest workspace remove <name>

See also