PackC Reference

Complete command-line reference for the PromptKit Pack Compiler (packc).

Overview

PackC is the official compiler for PromptKit packs. It transforms YAML prompt configurations into optimized, validated JSON pack files ready for use with the SDK.

Commands

compile - Compile all prompts from arena.yaml into a pack
compile-prompt - Compile a single prompt to pack format
validate - Validate a pack file
inspect - Display pack information and structure
version - Show packc version

Quick Reference

Common Usage

# Compile all prompts into a pack
packc compile --config arena.yaml --output app.pack.json --id my-app

# Validate a pack
packc validate app.pack.json

# Inspect pack contents
packc inspect app.pack.json

Installation

# Install from source
go install github.com/AltairaLabs/PromptKit/tools/packc@latest

# Or use pre-built binary
# Download from GitHub releases

Pack File Format

PackC produces .pack.json files with this structure:

{
  "id": "my-app",
  "name": "My Application",
  "version": "1.0.0",
  "template_engine": "go",
  "prompts": {
    "task_type": {
      "system": "System prompt...",
      "user_template": "User template...",
      "parameters": {...},
      "tools": [...],
      "variables": {...}
    }
  }
}