Skip to content

PPG CLI 0.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 26 Feb 03:10
· 1 commit to main since this release

PPG 0.3.0 — Global Prompts, Cron Scheduling & Schedules Dashboard

This release adds cross-project reuse, automated scheduling, and a new dashboard tab — making ppg a proper platform for managing recurring AI agent workflows.

Highlights

Global Prompts, Templates & Swarms

Create prompts, templates, and swarm definitions in ~/.ppg/ and use them from any project. No more copy-pasting between repos.

~/.ppg/
├── prompts/       # Available everywhere via `ppg prompt`
├── templates/     # Available everywhere via `ppg spawn --template`
└── swarms/        # Available everywhere via `ppg swarm`

Project-local files always take precedence when names conflict. The dashboard marks global entries so you can tell where things come from.

Cron Scheduling

Define recurring agent tasks in .ppg/schedules.yaml and let the daemon handle the rest:

schedules:
  - name: nightly-review
    swarm: code-review
    cron: '0 2 * * *'
    vars:
      CONTEXT: 'Review all changes from the last 24 hours'
ppg cron start    # Start the scheduler daemon
ppg cron list     # Show schedules with next run times
ppg cron status   # Check daemon status
ppg cron stop     # Stop the daemon

Schedules Dashboard Tab

A full visual interface for managing cron schedules — YAML editor, daemon start/stop, and a dialog for creating new schedules. Lives alongside Prompts and Swarms in the dashboard sidebar.

New CLI Commands

Command What it does
ppg prompt <name> Spawn an agent from a prompt file (local or global)
ppg list prompts List available prompt files with variables and source
ppg cron start/stop/list/status Manage the cron scheduler daemon

Other Changes

  • Config directory renamed.pg/.ppg/ to match the CLI name
  • Internal error types renamedPgErrorPpgError, pgDir()ppgDir()
  • Dashboard fixes — New Prompt dialog layout, project picker sizing

Install

# CLI
npm install -g pure-point-guard

# Dashboard (macOS)
ppg install-dashboard

Or download PPG-CLI-Dashboard.dmg from the assets below.