Skip to main content

​
Synopsis

​
Description

Lists the organizations you belong to and lets you switch to one. capy org takes no arguments and no flags - the whole flow is interactive. Pick an org and Capy re-scopes your session to it, then asks which project in that org you want. If the current directory has a keep.lock, Capy rewrites it with the new org and project (clearing the pinned variable list) and resets .capy/sync-state, so the directory is now bound to the project you picked - run capy afterwards to sync its secrets. Outside a project directory, if the org already has projects, no keep.lock is written; only your session moves. If the org has no projects yet, Capy offers to create its first project in the current directory, which does write a keep.lock there. Picking the org you’re already on prints Already on <org>. and changes nothing.

​
Example

​
Which org each command uses

Almost everything reads the org from keep.lock - which is exactly the file capy org rewrites:
  • capy (sync), capy push, capy deploy, capy branch, and capy checkout use the org and project pinned in keep.lock.
  • capy users, capy grant-branch, and capy revoke-branch need a keep.lock and use the org in it.
  • capy invite, capy kick, and capy transport prefer the keep.lock org when you run them inside a project. Outside a project they fall back to your only org, or ask which one to use.

​
Creating an org, and empty orgs

Choosing Create new organization + asks for a name (org names must be globally unique), generates a recovery phrase for the new org’s master key and makes you confirm it, then continues into the first-project flow. Switching into any org that has no projects yet - new or not - offers to create its first project in the current directory. Capy refuses if the directory is already bound to another project and its .env still holds capy: values encrypted for that project; run capy in a fresh directory instead. If you switch into an org you belong to but have no encryption key for on this device, Capy stops and points you at capy redeem <code> with an invite code from that org. capy org is disabled in local-only mode - local mode has no organization or server to switch between.

​
See also

Last modified on August 11, 2026