@odradekk/vera-setup

Setup CLI for deploying Vera agent resources to Pi coding agent

Package details

← Back
package

Install @odradekk/vera-setup from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@odradekk/vera-setup
Package
@odradekk/vera-setup
Version
0.1.2
Published
May 5, 2026
Downloads
139/mo · 11/wk
Author
odradekk
License
MIT
Types
package
Size
421.7 KB
Dependencies
0 dependencies · 0 peers

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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.