Examples

Each page here is a complete sequence you can run start to finish, with the output you should see at each step. The guides explain how a feature works; these show a whole job getting done.

Before you begin

Every example assumes you have a deployed server and are signed in:

prk login https://prick.example.com

prk whoami

you@example.com (user)
role: admin (global)

If either of those does not work, start with the Quickstart.

The examples

Example	You end up with
Onboard a new service	A project, two environments, secrets loaded, and the app running
Migrate from a .env file	An existing repository’s secrets moved in, with .env deleted
Give CI read-only access	A service token that reads exactly one environment and nothing else
Respond to a leaked secret	The leak closed, the blast radius known, and a record of what happened
Script prk with --json	Reliable automation that fails loudly instead of silently

Conventions on these pages

A block with no output is something to run:

prk projects list

A plain block after it is what you should see:

api  API service  3 environment(s)

Examples use api as the project and production as the environment. Set them once and the flags disappear from every command:

export PRK_PROJECT=api
export PRK_ENV=production