Command Reference

Complete reference for all pfy CLI commands.

Command Structure

pfy [global-flags] <command> [subcommand] [flags]

Global Flags

Available on all commands:

Flag	Short	Description
--manager		Manager server URL
--token		Personal Access Token
--insecure-skip-tls-verify		Skip TLS verification (not for production)
--ci		CI/CD environment indicator
--verbose	-v	Verbose output with details
--quiet	-q	Minimal output for scripting

Core Commands

Setup & Configuration

Command	Description
login	Authenticate with ProductifyFW manager
init	Initialize new project configuration
sync	Sync project configuration from manager
version	Manage project version (show/set/bump)

Resource Management

Command	Description
project	Manage projects - the top-level organization units
tenant	Manage tenants within projects for multi-tenancy
application	Manage application instances within tenants
languagepack	Manage internationalization language packs
pilet	Manage pilet packages for microfrontend applications

CI/CD & Deployment

Command	Description
ci	Generate and update CI/CD pipeline templates
nomad	Manage Nomad job deployments

Authentication

• login - Authenticate with Manager

Command Categories

By Function

Setup & Configuration

• login - Initial authentication
• init - Initialize project configuration
• sync - Sync from manager
• version - Version management

Project Hierarchy

• project - Top-level organization
• tenant - Multi-tenant isolation
• application - Deployable instances

Customization

• languagepack - Internationalization
• pilet - Microfrontend packages

CI/CD

• ci - Pipeline template generation
• nomad - Nomad job deployment

By Development Phase

Getting Started

# 1. Authenticate
pfy login --server https://manager.example.com --token <token>

# 2. Initialize project
pfy init --name my-app --language go

# 3. Generate CI/CD
pfy ci update

Development

# Bump version
pfy version bump --part patch

# Promote application
pfy application promote --application-id <id> --target-tenant-id <tenant>

Production Operations

pfy login
pfy project create
pfy tenant create
pfy application create

Development

pfy module init
pfy theme init
pfy languagepack init

Release & Deploy

pfy release
pfy deploy
pfy ci update

Usage Patterns

Interactive Mode

Commands with required flags prompt for input:

pfy project create
# Prompts for: slug, name, description

Scripting Mode

Use --quiet for parseable output:

#!/bin/bash
pfy --quiet project list | grep "my-project"

CI/CD Mode

Use --ci flag for CI/CD environments:

pfy --ci deploy --environment production

Getting Help

General Help

pfy --help

Command Help

pfy project --help
pfy project create --help

Version Information

pfy --version

Common Patterns

Chaining Commands

# Get project ID and create tenant
PROJECT_ID=$(pfy project get --slug my-project | grep "ID:" | awk '{print $2}')
pfy tenant create --project-id $PROJECT_ID --slug tenant1 --name "Tenant 1"

Error Handling

if pfy project create --slug test --name "Test"; then
    echo "Project created successfully"
else
    echo "Failed to create project"
    exit 1
fi

Verbose Debugging

pfy --verbose project create --slug debug --name "Debug"

Next Steps

Explore detailed documentation for each command:

Setup Commands

• login - Authentication
• init - Initialize project configuration
• sync - Sync from manager
• version - Version management

Resource Management

• project - Project management
• tenant - Tenant management
• application - Application management
• languagepack - Language pack management
• pilet - Pilet package management

CI/CD

• ci - CI/CD pipeline template generation
• nomad - Nomad deployment management

Guides

• Project Configuration - Working with project.yaml
• Version Management - Semantic versioning
• Auto-Versioning - CI/CD version automation

For additional information, use pfy --help or pfy <command> --help to see all available options.