Projects

List, select, and inspect DepVault projects. Most CLI commands require an active project — set one with depvault project select.

depvault project list

List all accessible projects. The active project is marked with *.

depvault project list

  ID                                     Name              Role
  ───────────────────────────────────────────────────────────────
* b3f1a2c4-5678-9def-0123-456789abcdef   my-web-app        OWNER
  a1b2c3d4-e5f6-7890-abcd-ef1234567890   backend-service   MEMBER

Use --output json for machine-readable output.

depvault project select

Set the active project. The ID is persisted to ~/.depvault/config.json.

depvault project select <id>

After selecting a project, commands like env list, env pull, and analyze operate on it automatically.

depvault project info

Display details about a project. Uses the active project if no ID is provided.

depvault project info [id]

Project:       my-web-app
ID:            b3f1a2c4-5678-9def-0123-456789abcdef
Description:   Main web application frontend and API
Created:       2025-11-20T14:30:00Z
Members:       4
Vault Groups:  2
Analyses:      12
Your Role:     OWNER

Use --project <id> to query a specific project without changing the active selection.