### Execute First Command

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-oauth2-device-code/printing-press-oauth2-device-code/README.md

Run your first command after setup to test the CLI's functionality. This example shows how to list items.

```bash
printing-press-oauth2-pp-cli items
```

--------------------------------

### Install CLI and Skill

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-oauth2-device-code/printing-press-oauth2-device-code/README.md

Installs both the printing-press-oauth2 CLI binary and the agent skill. Use this command for a complete setup.

```bash
npx -y @mvanhorn/printing-press-library install printing-press-oauth2
```

--------------------------------

### Setup and Binary Path Configuration

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press-polish/SKILL.md

This script sets up the printing press environment by defining home and library paths, and locating the cli-printing-press binary. It prioritizes a provided binary path, falls back to arguments, and finally searches the system PATH. If the binary is not found, it provides installation instructions.

```bash
# min-binary-version: 4.0.0

PRESS_HOME="${PRINTING_PRESS_HOME:-$HOME/printing-press}"
PRESS_LIBRARY="$PRESS_HOME/library"

# Mid-pipeline callers may pass printing_press_bin: <abs-path> in the args
# bundle. Prefer it so forked polish runs keep using the parent skill's
# preflight-selected binary instead of re-resolving through PATH.
PRINTING_PRESS_BIN="${PRINTING_PRESS_BIN:-""}"
if [ -z "$PRINTING_PRESS_BIN" ] && [ -n "${ARGUMENTS:-}" ]; then
  PRINTING_PRESS_BIN="$(printf '%s\n' "$ARGUMENTS" | sed -nE 's/^[[:space:]]*printing_press_bin:[[:space:]]*(.+)$/\1/p' | head -1)"
fi
if [ -z "$PRINTING_PRESS_BIN" ]; then
  PRINTING_PRESS_BIN="$(command -v cli-printing-press 2>/dev/null || true)"
fi

if [ -z "$PRINTING_PRESS_BIN" ]; then
  echo "cli-printing-press binary not found."
  echo "Install with:  go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest"
  return 1 2>/dev/null || exit 1
fi
echo "PRINTING_PRESS_BIN=$PRINTING_PRESS_BIN"
```

--------------------------------

### Install CLI and Agent Skill

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/README.md

Installs both the learn-loop-example-pp-cli binary and the pp-learn-loop-example agent skill. This is the recommended installation path for full functionality.

```bash
npx -y @mvanhorn/printing-press-library install learn-loop-example
```

--------------------------------

### Install agent-browser with brew or npm

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/references/browser-sniff-capture.md

Installs the agent-browser tool using either brew or npm. Provides instructions for manual Node.js installation if neither is found. Requires a subsequent manual user-run step for agent-browser setup.

```bash
# Detect Node.js package manager
if command -v brew >/dev/null 2>&1; then
  brew install agent-browser
elif command -v npm >/dev/null 2>&1; then
  npm install -g agent-browser
else
  echo "Neither brew nor npm found. Install Node.js first: https://nodejs.org/"
  # Fall back to manual HAR
fi
```

--------------------------------

### Example of External Tool Install Commands

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/docs/solutions/best-practices/cross-repo-coordination-with-printing-press-library-2026-05-06.md

These commands are embedded in SKILL.md templates and may introduce new flags that need to be allowlisted.

```bash
npx -y @mvanhorn/printing-press install mercury --cli-only
```

```bash
hermes skills install mvanhorn/printing-press-library/cli-skills/pp-mercury --force
```

--------------------------------

### Install BLE Desk Lamp CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-control/ble-desk-lamp/SKILL.md

Installs the ble-desk-lamp-pp-cli using npx. Ensure the CLI is installed before using skill commands.

```bash
npx -y @mvanhorn/printing-press-library install ble-desk-lamp --cli-only
```

--------------------------------

### Manual agent-browser setup command

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/references/setup-checks.md

This command is surfaced to the user for manual execution after 'agent-browser' has been installed via a package manager. It ensures the browser-binary setup is complete, which is necessary for 'agent-browser' to function correctly. The leading '!' indicates it's a user-executed command.

```text
! agent-browser install
```

--------------------------------

### Install BLE Session Appliance CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-session/ble-session-appliance/SKILL.md

Installs the `ble-session-appliance-pp-cli` binary using npx. Ensure the installation directory is on your system's PATH.

```bash
npx -y @mvanhorn/printing-press-library install ble-session-appliance --cli-only
```

--------------------------------

### Manual Binary Installation

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/README.md

Installs or updates the generator binary using Go. Ensure Go 1.26.4 or newer is installed.

```bash
go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest
```

--------------------------------

### Install BLE Opaque Binary CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-opaque/ble-opaque-binary/SKILL.md

Install the `ble-opaque-binary-pp-cli` using npx. Ensure the installation directory is added to your system's PATH.

```bash
npx -y @mvanhorn/printing-press-library install ble-opaque-binary --cli-only
```

--------------------------------

### Install Printing Press Rich CLI and Skill

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-rich-auth/printing-press-rich-auth/README.md

Use this command to install both the CLI binary and the agent skill. This is the recommended installation path for full functionality.

```bash
npx -y @mvanhorn/printing-press-library install printing-press-rich
```

--------------------------------

### Install Hermes Skill from CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-public-param-names/public-param-golden/README.md

Installs the focused Hermes skill 'pp-public-param-golden' using the Hermes CLI. Use --force to overwrite existing installations.

```bash
hermes skills install mvanhorn/printing-press-library/cli-skills/pp-public-param-golden --force
```

--------------------------------

### Run First Command

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-rich-auth/printing-press-rich-auth/README.md

Execute the 'items' command to test basic functionality after setup.

```bash
printing-press-rich-pp-cli items
```

--------------------------------

### Update install command in template

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/docs/solutions/best-practices/cross-repo-coordination-with-printing-press-library-2026-05-06.md

This diff shows an example of adding a new install command with a `--cli-only` flag to a skill template.

```diff
# internal/generator/templates/skill.md.tmpl
+1. Install via the Printing Press installer:
+   ```bash
+   npx -y @mvanhorn/printing-press install {{.Name}} --cli-only
+   ```
```

--------------------------------

### Install MCP Server

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api/printing-press-golden/SKILL.md

Installs the MCP binary from a public library entry or pre-built release and registers it. Use this command to set up the MCP server for the CLI.

```bash
claude mcp add printing-press-golden-pp-mcp -- printing-press-golden-pp-mcp
```

--------------------------------

### Get Installed and Latest Go Package Versions

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/SKILL.md

This snippet checks the installed version of the CLI Printing Press and fetches the latest available version using 'go list'. It's used when the tool is installed standalone and 'go' is available.

```shell
_installed=$("$PRINTING_PRESS_BIN" version --json 2>/dev/null | sed -nE 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p')
_latest=""

if [ -n "$_installed" ]; then
  _latest=$(go list -m -json github.com/mvanhorn/cli-printing-press/v4@latest 2>/dev/null | awk '
    /"Version":/ {
      version=$2
      gsub(/[ ",]/, "", version)
      sub(/^v/, "", version)
      print version
      exit
    }
  ')
fi
```

--------------------------------

### Install CLI Only

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/README.md

Installs only the learn-loop-example CLI binary, excluding the associated agent skill. Use this if you do not need the agent functionality.

```bash
npx -y @mvanhorn/printing-press-library install learn-loop-example --cli-only
```

--------------------------------

### Install Skill Only

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/README.md

Installs only the pp-learn-loop-example agent skill, skipping the CLI binary. This is useful for updating or reinstalling just the skill.

```bash
npx -y @mvanhorn/printing-press-library install learn-loop-example --skill-only
```

--------------------------------

### Verify browser-use CLI Compatibility

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/references/browser-sniff-capture.md

Checks if the installed browser-use version meets the minimum requirement (v0.12.3) for CLI commands. Uses pip metadata to get the version and performs a lexicographical comparison.

```bash
# browser-use has no --version flag; get version from pip metadata
BROWSER_USE_VERSION=$(pip show browser-use 2>/dev/null | grep -i '^Version:' | awk '{print $2}')
MIN_BROWSER_USE="0.12.3"

# Compare versions (lexicographic sort works for dotted semver)
if printf '%s
' "$MIN_BROWSER_USE" "$BROWSER_USE_VERSION" | sort -V | head -1 | grep -qx "$MIN_BROWSER_USE"; then
  BROWSER_USE_COMPAT=true
else
  BROWSER_USE_COMPAT=false
fi
```

--------------------------------

### Quick Start Commands for Printing Press Catalog

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press-catalog/SKILL.md

These commands demonstrate basic interactions with the printing-press-catalog skill, including initiating the skill, installing a specific tool (stripe), and searching for tools (auth).

```bash
/printing-press-catalog
/printing-press-catalog install stripe
/printing-press-catalog search auth
```

--------------------------------

### Run First Command

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/README.md

Execute a basic command, such as listing available games, to test the CLI after setup.

```bash
learn-loop-example-pp-cli games
```

--------------------------------

### Install Generalization Rules

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/AGENTS.md

Use 'teach-pattern' and 'teach-lookup' to install manual generalization rules for families of queries. These commands are write operations and help in creating broader learning associations.

```bash
teach-pattern
teach-lookup
```

--------------------------------

### Add Go Bin to PATH

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/README.md

If 'command not found' errors occur after 'go install', add your $GOPATH/bin directory to your system's PATH environment variable. This example shows how to add it to a shell profile.

```bash
# Add to your shell profile (e.g., .bashrc, .zshrc)
export PATH=$PATH:~/go/bin
```

--------------------------------

### Printing Press CLI Setup Contract

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press-score/SKILL.md

This script sets up the environment for the printing-press-score tool, including deriving scope variables and ensuring the correct binary is on the PATH. It handles local builds and checks for binary installation.

```bash
# min-binary-version: 4.0.0

# Derive scope first — needed for local build detection
_scope_dir="$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")"
_scope_dir="$(cd "$_scope_dir" && pwd -P)"

# Prefer local build when running from inside the printing-press repo.
_press_repo=false
if [ -x "$_scope_dir/cli-printing-press" ] && [ -d "$_scope_dir/cmd/cli-printing-press" ]; then
  _press_repo=true
  export PATH="$_scope_dir:$PATH"
  echo "Using local build: $_scope_dir/cli-printing-press"
elif ! command -v cli-printing-press >/dev/null 2>&1; then
  if [ -x "$HOME/go/bin/cli-printing-press" ]; then
    echo "cli-printing-press found at ~/go/bin/cli-printing-press but not on PATH."
    echo "Add GOPATH/bin to your PATH:  export PATH=\"
$HOME/go/bin:\
$PATH\""
  else
    echo "cli-printing-press binary not found."
    echo "Install with:  go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest"
  fi
  return 1 2>/dev/null || exit 1
fi

# Resolve and emit the absolute path the agent must use for every later
# `cli-printing-press` invocation. `export PATH` above only affects this one
# Bash tool call; subsequent calls open a fresh shell and resolve bare
# `cli-printing-press` against the user's default PATH, where a stale global
# can silently shadow the local build. The agent captures this marker and
# substitutes the absolute path into every later invocation.
if [ "$_press_repo" = "true" ]; then
  PRINTING_PRESS_BIN="$_scope_dir/cli-printing-press"
else
  PRINTING_PRESS_BIN="$(command -v cli-printing-press 2>/dev/null || true)"
fi
echo "PRINTING_PRESS_BIN=$PRINTING_PRESS_BIN"

PRESS_BASE="$(basename "$_scope_dir" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9_-]/-/g; s/^-+//; s/-+$//')"
if [ -z "$PRESS_BASE" ]; then
  PRESS_BASE="workspace"
fi

PRESS_SCOPE="$PRESS_BASE-$(printf '%s' "$_scope_dir" | shasum -a 256 | cut -c1-8)"
PRESS_HOME="${PRINTING_PRESS_HOME:-$HOME/printing-press}"
PRESS_RUNSTATE="$PRESS_HOME/.runstate/$PRESS_SCOPE"
PRESS_LIBRARY="$PRESS_HOME/library"
PRESS_MANUSCRIPTS="$PRESS_HOME/manuscripts"
PRESS_CURRENT="$PRESS_RUNSTATE/current"

mkdir -p "$PRESS_RUNSTATE" "$PRESS_LIBRARY" "$PRESS_MANUSCRIPTS" "$PRESS_CURRENT"

```

--------------------------------

### Build, Test, and Lint Go Project

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/README.md

Standard commands for building, testing, and formatting the Go project. Also includes running linters for code quality.

```bash
go build -o ./cli-printing-press ./cmd/cli-printing-press
go test ./...
go fmt ./...
golangci-lint run ./...
```

--------------------------------

### Start BLE Session (Live)

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-session/ble-session-appliance/SKILL.md

Initiates a BLE session in live mode. Requires the `--live` flag.

```bash
ble-session-appliance-pp-cli session start --live --json
```

--------------------------------

### Install Printing Press Oauth2 CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-oauth2-device-code/printing-press-oauth2-device-code/SKILL.md

Installs the printing-press-oauth2 CLI using npx. Ensure Node.js is installed and the binary directory is on your PATH after installation.

```bash
npx -y @mvanhorn/printing-press-library install printing-press-oauth2 --cli-only
```

--------------------------------

### Install agent-browser with brew or npm

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/references/setup-checks.md

Installs the 'agent-browser' tool. Prioritizes 'brew install' for macOS, falling back to 'npm install -g' for global Node.js installations. Provides an error message if neither 'brew' nor 'npm' is found.

```bash
if command -v brew >/dev/null 2>&1;
  then
  brew install agent-browser
elif command -v npm >/dev/null 2>&1;
  then
  npm install -g agent-browser
else
  echo "Neither brew nor npm found. Install Node.js first: https://nodejs.org/"
fi
```

--------------------------------

### Verify Go Toolchain Installation

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/SKILL.md

This snippet checks if the Go toolchain is installed and accessible via the PATH. If not, it provides instructions on how to install Go and verify the installation.

```bash
if ! command -v go >/dev/null 2>&1; then
  echo ""
  echo "[setup-error] Go toolchain not found."
  echo ""
  echo "The Printing Press generator runs Go-based quality gates after generation."
  echo "Install Go 1.26.4 or newer from https://go.dev/dl/, then verify with:"
  echo "  go version"
  echo "Then re-run /printing-press."
  echo ""
  return 1 2>/dev/null || exit 1
fi
```

--------------------------------

### Preview Start Command (Dry Run)

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-session/ble-session-appliance/SKILL.md

Generates a JSON preview of the start command without executing it. Useful for verifying the intended actions.

```bash
ble-session-appliance-pp-cli start --dry-run --json
```

--------------------------------

### Verify CLI Setup and Credentials

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api-oauth2-device-code/printing-press-oauth2-device-code/README.md

Check your configuration and credentials to ensure the CLI is set up correctly. This command helps diagnose potential issues with your setup.

```bash
printing-press-oauth2-pp-cli doctor
```

--------------------------------

### CLI Printing Press Setup Script

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press-amend/SKILL.md

This script sets up the environment for using the cli-printing-press tool. It derives the scope, prefers a local build if available, and configures essential environment variables like PRINTING_PRESS_BIN, PRESS_HOME, and directory paths. It also includes a currency-floor check to ensure the installed binary meets the minimum supported version.

```bash
# min-binary-version: 4.0.0

# Derive scope first — needed for local build detection
_scope_dir="$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")"
_scope_dir="$(cd "$_scope_dir" && pwd -P)"

# Prefer local build when running from inside the printing-press repo.
_press_repo=false
if [ -x "$_scope_dir/cli-printing-press" ] && [ -d "$_scope_dir/cmd/cli-printing-press" ]; then
  _press_repo=true
  export PATH="$_scope_dir:$PATH"
  echo "Using local build: $_scope_dir/cli-printing-press"
elif ! command -v cli-printing-press >/dev/null 2>&1; then
  if [ -x "$HOME/go/bin/cli-printing-press" ]; then
    echo "cli-printing-press found at ~/go/bin/cli-printing-press but not on PATH."
    echo "Add GOPATH/bin to your PATH:  export PATH=\"
$HOME/go/bin:$PATH\""
  else
    echo "cli-printing-press binary not found."
    echo "Install with:  go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest"
  fi
  return 1 2>/dev/null || exit 1
fi

# Resolve and emit the absolute path the agent must use for every later
# `cli-printing-press` invocation. `export PATH` above only affects this one
# Bash tool call; subsequent calls open a fresh shell and resolve bare
# `cli-printing-press` against the user's default PATH, where a stale global
# can silently shadow the local build. The agent captures this marker and
# substitutes the absolute path into every later invocation.
if [ "$_press_repo" = "true" ]; then
  PRINTING_PRESS_BIN="$_scope_dir/cli-printing-press"
else
  PRINTING_PRESS_BIN="$(command -v cli-printing-press 2>/dev/null || true)"
fi
echo "PRINTING_PRESS_BIN=$PRINTING_PRESS_BIN"

PRESS_BASE="$(basename "$_scope_dir" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9_-]/-/g; s/^-+//; s/-+$//')"
if [ -z "$PRESS_BASE" ]; then
  PRESS_BASE="workspace"
fi

PRESS_SCOPE="$PRESS_BASE-$(printf '%s' "$_scope_dir" | shasum -a 256 | cut -c1-8)"
PRESS_HOME="${PRINTING_PRESS_HOME:-$HOME/printing-press}"
PRESS_RUNSTATE="$PRESS_HOME/.runstate/$PRESS_SCOPE"
PRESS_LIBRARY="$PRESS_HOME/library"
PRESS_MANUSCRIPTS="$PRESS_HOME/manuscripts"
PRESS_CURRENT="$PRESS_RUNSTATE/current"

mkdir -p "$PRESS_RUNSTATE" "$PRESS_LIBRARY" "$PRESS_MANUSCRIPTS" "$PRESS_CURRENT"

# --- Currency-floor check (standalone, fail-open) ---
# Hard-stop on binaries below the published supported floor so amend does not
# regenerate CLIs with since-fixed bugs. Repo checkouts build from source and
# are exempt. The floor is clamped to <= latest so a bad value cannot brick
# every install. Fetched fresh each run rather than reusing the printing-press
# preflight's TTL cache: amend is low-frequency, so the bounded curl + go-list
# cost is not worth its own cache here.
if [ "$_press_repo" != "true" ] && command -v curl >/dev/null 2>&1; then
  _semver_lt() {
    awk -v a="$1" -v b="$2" 'BEGIN {
      split(a, x, "."); split(b, y, ".")
      for (i = 1; i <= 3; i++) {
        if ((x[i] + 0) < (y[i] + 0)) exit 0
        if ((x[i] + 0) > (y[i] + 0)) exit 1
      }
      exit 1
    }'
  }
  _floor_installed=$("$PRINTING_PRESS_BIN" version --json 2>/dev/null | sed -nE 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p')
  _floor_doc=$(curl -fsSL --max-time 5 \
    https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/supported-versions.txt 2>/dev/null || true)
  _floor_min=$(printf '%s\n' "$_floor_doc" | awk -F= '/^min_supported=/{print $2; exit}')
  _floor_reason=$(printf '%s\n' "$_floor_doc" | sed -nE 's/^reason=//p' | head -n 1)
  _floor_latest=""
  if command -v go >/dev/null 2>&1; then
    _floor_latest=$(go list -m -json github.com/mvanhorn/cli-printing-press/v4@latest 2>/dev/null | awk '/"Version":/{v=$2; gsub(/[ ",]/,"",v); sub(/^v/,"",v); print v; exit}')
  fi
  if [ -n "$_floor_min" ] && [ -n "$_floor_installed" ] && [ -n "$_floor_latest" ] &&
     _semver_lt "$_floor_installed" "$_floor_min" &&
     ! _semver_lt "$_floor_latest" "$_floor_min"; then
    echo ""
    echo "[upgrade-required] printing-press v$_floor_min is the minimum supported version (you have v$_floor_installed)"
    echo "PRESS_REQUIRED_MIN=$_floor_min"
    echo "PRESS_REQUIRED_INSTALLED=$_floor_installed"
    echo "PRESS_REQUIRED_REASON=$_floor_reason"
    echo ""
  fi
fi
```

--------------------------------

### Direct Go Binary Build and Test

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/ONBOARDING.md

Demonstrates the standard Go commands for building and testing the CLI binary directly. This is used by developers working on the codebase.

```bash
go build
```

```bash
go test
```

--------------------------------

### Root Command Setup

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/cases/generate-device-ble-control/artifacts.txt

Initializes the root command for the CLI, including persistent flags and subcommands.

```go
package cli

import (
	"fmt"

	"github.com/spf13/cobra"
	"github.com/mvanhorn/cli-printing-press/ble-desk-lamp/internal/cliutil"
)

var RootCmd = &cobra.Command{
	Use:   "ble-desk-lamp-pp-cli",
	Short: "CLI for controlling the BLE Desk Lamp",
	Long:  "A command-line interface for interacting with and controlling the BLE Desk Lamp.",
	PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
		// Verify environment variables are set.
		return cliutil.VerifyEnv(cmd.Context())
	},
}

func init() {
	// Add global flags here.
	// For example:
	// RootCmd.PersistentFlags().StringVarP(&cfgFile, "config", "c", "", "config file (default is $HOME/.ble-desk-lamp-pp-cli.yaml)")

	// Add subcommands here.
	// For example:
	// RootCmd.AddCommand(version.Cmd)
	// RootCmd.AddCommand(device.Cmd)
}

// Execute adds all child commands to the root command and sets flags appropriately. This is called by main.main(). It only needs to happen once to the RootCmd.
func Execute() {
	//nolint:forbidigo
	fmt.Println("Executing RootCmd")
}
```

--------------------------------

### Verify BLE Desk Lamp CLI Installation

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-control/ble-desk-lamp/SKILL.md

Verifies the installation of the ble-desk-lamp-pp-cli by checking its version. Ensure the installation directory is on your PATH.

```bash
ble-desk-lamp-pp-cli --version
```

--------------------------------

### Transactions Get

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/internal/pipeline/docs/plans/plaid-pipeline/dogfood-evidence/tier1-resources/processor-help.txt

Get transaction data.

```APIDOC
## plaid-cli processor transactions-get

### Description
Get transaction data.

### Usage
plaid-cli processor transactions-get [flags]

### Flags
See global flags and the following flags specific to this command:
-h, --help   help for transactions-get
```

--------------------------------

### Discover Capabilities with CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-learn-loop-api/learn-loop-example/AGENTS.md

Use the 'which' command to discover capabilities and '<command> --help' to inspect command details. This helps in understanding available actions and their parameters.

```bash
learn-loop-example-pp-cli which "<capability>" --json
learn-loop-example-pp-cli <command> --help
```

--------------------------------

### Install CLI and Skill

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api/printing-press-golden/README.md

Installs both the printing-press-golden CLI binary and the pp-printing-press-golden agent skill.

```bash
npx -y @mvanhorn/printing-press-library install printing-press-golden
```

--------------------------------

### Install BLE Temperature Sensor CLI

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble/ble-temperature-sensor/SKILL.md

Installs the ble-temperature-sensor CLI using npx. Ensure the CLI is installed before using skill commands.

```bash
npx -y @mvanhorn/printing-press-library install ble-temperature-sensor --cli-only
```

--------------------------------

### CLI Command Example with Direct Path Parameter Access

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/docs/solutions/logic-errors/codegen-args-index-vs-positional-ordinal-2026-05-12.md

Shows an example of accessing a direct path parameter within a CLI command.

```go
contacts/{email}/email-addresses
```

--------------------------------

### Install Public Param Golden CLI and Skill

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-public-param-names/public-param-golden/README.md

Installs both the CLI binary and the associated agent skill. This is the recommended installation method for full functionality.

```bash
npx -y @mvanhorn/printing-press-library install public-param-golden
```

--------------------------------

### Start BLE Session (Confirm Physical Effect)

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-device-ble-session/ble-session-appliance/SKILL.md

Executes the start command after a dry-run verification. Requires `--confirm-physical-effect` to proceed.

```bash
ble-session-appliance-pp-cli start --confirm-physical-effect --json
```

--------------------------------

### Verify Printing Press Golden CLI Installation

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/testdata/golden/expected/generate-golden-api/printing-press-golden/SKILL.md

Verifies the installation of the printing-press-golden-pp-cli by checking its version. This command should return the CLI version if installed correctly.

```bash
printing-press-golden-pp-cli --version
```

--------------------------------

### Install browser-use with uv or pip

Source: https://github.com/mvanhorn/cli-printing-press/blob/main/skills/printing-press/references/setup-checks.md

Installs the 'browser-use' tool. Prioritizes 'uv tool install' for isolated environments and PATH inclusion, falling back to 'pip install' for the active venv. Provides an error message if neither 'uv' nor 'pip' is found.

```bash
if command -v uv >/dev/null 2>&1;
  then
  uv tool install browser-use
elif command -v pip >/dev/null 2>&1;
  then
  pip install browser-use
else
  echo "Neither uv nor pip found. Install Python first: https://www.python.org/downloads/"
fi
```