Documentation Index
Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
Use this file to discover all available pages before exploring further.
Template Catalog CLI
The PraisonAI CLI provides commands for interacting with the template catalog - browse templates, build catalogs locally, sync sources, and validate template files.
Browse Templates
Open the template catalog in your default browser.
# Open catalog in browser
praisonai templates browse
# Print URL only (don't open browser)
praisonai templates browse --print
# Use custom catalog URL
praisonai templates browse --url https://my-catalog.example.com
| Option | Description |
|---|
--print | Print the catalog URL without opening browser |
--url <url> | Use a custom catalog URL |
--local | Run local catalog server (if installed) |
Validate Templates
Validate TEMPLATE.yaml files for correctness.
# Validate templates in default location
praisonai templates validate
# Validate specific directory
praisonai templates validate --source ./my-templates
# Strict mode (warnings become errors)
praisonai templates validate --strict
# JSON output format
praisonai templates validate --json
# Combine options
praisonai templates validate --source ./templates --strict --json
| Option | Description |
|---|
--source <dir> | Directory containing templates to validate |
--strict | Treat warnings as errors |
--json | Output results as JSON |
Validation Checks
The validator checks for:
- Required fields:
name, version, description
- Valid version format (semver)
- Workflow file existence
- Agents file existence
- README.md presence
- Tag format (lowercase)
Build Catalog
Build the template catalog locally.
# Build with defaults
praisonai templates catalog build
# Specify output directory
praisonai templates catalog build --out ./dist
# Use custom source directory
praisonai templates catalog build --source ./my-templates
# Minify output
praisonai templates catalog build --minify
# Combine options
praisonai templates catalog build --out ./public/data --source ./templates --minify
| Option | Description |
|---|
--out <dir> | Output directory for generated files |
--source <path> | Source directory containing templates |
--minify | Minify JSON output |
Generated Files
The build command generates:
templates.json - Searchable index of all templatesrss.xml - RSS feed for new templates
Sync Sources
Sync template sources from GitHub repositories.
# Sync all configured sources
praisonai templates catalog sync
# Sync specific source
praisonai templates catalog sync --source agent-recipes
# Use custom config file
praisonai templates catalog sync --config ./my-config.json
# Specify cache directory
praisonai templates catalog sync --cache-dir ./my-cache
| Option | Description |
|---|
--source <name> | Sync only a specific source |
--config <path> | Path to catalog config file |
--cache-dir <dir> | Override cache directory |
List Templates
List all available templates.
# List all templates
praisonai templates list
# Show search paths
praisonai templates list --paths
# Filter by source
praisonai templates list --source custom
# Add custom directory
praisonai templates list --custom-dir ./my-templates
Search Templates
Search templates by name or tags.
# Search by keyword
praisonai templates search video
# Search with offline mode
praisonai templates search transcript --offline
Template Info
Show detailed information about a template.
# Get template info
praisonai templates info ai-video-editor
# With custom directory
praisonai templates info my-template --custom-dir ./templates
Run Templates
Run a template directly.
# Run a template
praisonai templates run transcript-generator ./audio.mp3
# With options
praisonai templates run ai-video-editor input.mp4 --output edited.mp4
# Strict tool checking
praisonai templates run my-template --strict-tools
Add Templates
Add templates from GitHub or local paths.
# Add from GitHub
praisonai templates add github:user/repo/template-name
# Add from local directory
praisonai templates add ./my-local-template
Manage Sources
Add or remove template sources from persistent config.
# Add a source
praisonai templates add-sources github:MervinPraison/Agent-Recipes
# Remove a source
praisonai templates remove-sources github:MervinPraison/Agent-Recipes
Complete Command Reference
| Command | Description |
|---|
praisonai templates browse | Open catalog in browser |
praisonai templates browse --print | Print catalog URL |
praisonai templates validate | Validate templates |
praisonai templates validate --source <dir> | Validate specific directory |
praisonai templates validate --strict | Strict validation mode |
praisonai templates validate --json | JSON output |
praisonai templates catalog build | Build catalog locally |
praisonai templates catalog build --out <dir> | Build to specific directory |
praisonai templates catalog sync | Sync template sources |
praisonai templates catalog sync --source <name> | Sync specific source |
praisonai templates list | List all templates |
praisonai templates list --paths | Show search paths |
praisonai templates search <query> | Search templates |
praisonai templates info <name> | Show template details |
praisonai templates run <name> | Run a template |
praisonai templates add <source> | Add a template |
praisonai templates add-sources <src> | Add persistent source |
praisonai templates remove-sources <src> | Remove persistent source |
