This document provides detailed instructions for using the pine CLI.

Looking for when and why to use PINE in your platform workflow?
See PINE Usage Guide

Install the CLI and set the following environment variable:

export PORC_TOKEN=<your-api-token>

• pine lint <file> — Basic schema validation (kind + schema_version)
• pine validate <file> — Extended validation using blueprint schema

• pine submit <blueprint.json>
  Uploads blueprint and returns run_id.

• pine build --run-id <id>
  Tells PORC to render and upload Terraform templates to TFE.

• pine plan --run-id <id>
  Triggers a TFE plan.

• pine apply --run-id <id>
  Triggers a TFE apply using the uploaded configuration.

pine submit my-blueprint.json
pine build --run-id porc-20250505-abc123
pine plan --run-id porc-20250505-abc123
pine apply --run-id porc-20250505-abc123

• PINE Usage Guide
• Architecture Overview
• API Reference