vera-setup

vera-setup is a standalone CLI for deploying Vera's non-standard resources into a Pi coding agent installation.

It installs resources that Pi packages do not manage directly, including:

• subagent YAMLs
• chimera YAMLs
• skills
• prompt rules
• config JSON files
• local TypeScript extensions
• themes
• model/provider examples
• auth template files
• Vera memory state directory
• Vera package entries in settings.json

Installation

npm install -g vera-setup

Usage

vera-setup [options]

Options

• --agent-dir <path> - Target Pi agent directory. Defaults to $PI_CODING_AGENT_DIR or ~/.pi/agent
• --scope <scope> - npm scope for Vera packages in settings.json (example: @s1n)
• --dry-run - Show what would be done without writing files
• --force - Overwrite existing deployable files and directories when supported
• --skip-packages - Do not update settings.json package entries
• --help - Print usage information

Installation flow

1. Run vera-setup to deploy Vera's non-standard resources into your Pi agent directory.
2. Install the Vera packages with pi install npm:vera-* for each package, or let Pi auto-install them from the packages entries written to settings.json.

If you publish the Vera packages under an npm scope, run vera-setup --scope @your-scope so the generated settings.json entries point at the correct package names.

auth.json

If auth.json is missing, vera-setup will create it from assets/auth.example.json.

You must then edit auth.json and fill in your API keys manually before Vera's web-backed services can work.