setup

Configure a repository's Veris sandbox wiring and verify one application run against service twins.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/veris-ai/plugins --skill setup-veris-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/veris-ai/plugins/tree/main/veris/skills/setup
Command: npx skills add https://github.com/veris-ai/plugins --skill setup-veris-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires veris.

What problem does it solve? Connecting an application's tests to Veris service twins requires choosing an execution tier, creating environments, building images, and proving traffic reaches the sandbox. This Skill performs that wiring once and records the working command so later build and fix runs reuse it. ## Core Features & Use Cases - Session and machine checks: Detects plugin-managed sessions, runs veris doctor, and resolves login, Docker, and sandboxing issues before wiring anything. - Tier selection and environment creation: Chooses between direct, container, and hosted execution tiers based on how the code calls vendors, then creates or adopts a Veris environment with the required services. - Proving run and handoff: Runs the smallest vendor-calling test through veris run, validates the receipt ledgers, and writes .veris/twin.yaml, .veris/NOTES.md, and .veris/setup.json for later tasks. - Use Case: An engineer adds Veris to a repository that calls Stripe and Google Calendar; the Skill identifies the vendor hostnames, creates the environment, proves a test run reaches both twins, and saves the verified command. ## Quick Start Ask the assistant to run the Veris setup command to wire this repository and verify one application test run against the service twins.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Veris for a repository that calls external APIs?▼

Run the setup command, which checks the session and machine with `veris doctor`, identifies vendor hostnames from the code, creates an environment with the required services, and proves one test run reaches the twins. It saves the working command in `.veris/NOTES.md` for later build and fix runs.

How do I choose between direct, container, and hosted Veris tiers?▼

Use the direct tier when every vendor URL comes from an environment variable the app already reads. Use the container tier (`veris run --image`) when hostnames are hardcoded and Docker is available. Use the hosted tier when remote execution is requested or Docker cannot run.

Does Veris setup require Docker to be installed?▼

Docker is required only for the container tier. The direct tier needs no proxy at all, and the hosted tier runs tests in a remote box, so setup can proceed without a local Docker daemon in those paths.

Why does veris run exit with code 3 during setup?▼

Exit 3 means a requirement was unmet, usually because the test never calls the vendor, the hostname has no matching twin, the SDK refused the proxy certificate, or the twin is a non-proxied data plane. The Skill checks each cause in order without changing the test's vendor call.

Can setup reuse an existing Veris environment instead of creating one?▼

Yes, but only when the existing environment belongs to this project, meaning its services exactly match your list or its server name is the project's. Adopt it with `veris env create <name> --from <full id>`; otherwise create a new environment to avoid sharing state with another project.