Skip to content
PromptKit Logo PromptKit

PackC Reference

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

Overview

Section titled “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

Section titled “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

Section titled “Quick Reference”

Common Usage

Section titled “Common Usage”
Terminal window
# 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

Section titled “Installation”
Terminal window
# Install from source
go install github.com/AltairaLabs/PromptKit/tools/packc@latest


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

Pack File Format

Section titled “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": {...}
    }
  }
}

See Also

Section titled “See Also”