PPG CLI 0.3.3

Changelog

• fix: remove resultFile from AgentEntryModel to fix dashboard sidebar

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.3.2

PPG CLI 0.3.2 — Visual Calendar, Agent Config Hub & Skills Management

What's New

Visual Calendar for Schedules

The Schedules tab is now a full calendar with Month, Week, and Day views. Click time slots to create schedules, click events to edit. High-frequency cron jobs render as bands. Includes a Swift cron parser, project-colored event blocks, current-time indicator, and ppg cron add/remove CLI commands.

Agent Config Tab

New unified tab replacing the old Skills sidebar. Three views behind a segmented control:

• CLAUDE.md — Edit all CLAUDE.md locations (project, local, global, rules) in one place
• Skills — Manage personal and project-scoped Claude Code skills with full frontmatter support
• Agents — Raw YAML editor for .ppg/config.yaml agent definitions

Human-Readable Schedule Picker

Schedule dialog now shows a time picker and repeat dropdown (Daily, Weekday, Weekly, Monthly, Hourly, Custom) instead of raw cron. Power users can still drop to the raw field.

Prompts & Swarms UX

• Filter toggle to switch between Prompts and Templates
• Right-click context menu with Rename and Delete on both lists

--branch Flag

ppg spawn --branch <name> checks out an existing branch into a new worktree — resume work on open PRs without manual git gymnastics.

Install

npm install -g pure-point-guard
ppg install-dashboard

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

PPG CLI 0.3.0

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 renamed — PgError → PpgError, 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.

PPG CLI 0.2.2

Changelog

• Remove folder icon from sidebar worktree rows
• Add adaptive theme system with light/dark mode support and appearance settings
• Compact sidebar: single-line worktrees, tighter rows, remove project icon

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.2.1

Changelog

• Fix tmux scroll not working in dashboard on M-series Macs

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.2.0

Changelog

• Replace sidebar project + button menu with command palette
• Fix single-pane hover overlay hidden behind terminal views
• chore: release v0.2.0
• Fix single-pane hover overlay close button to kill agent
• Remove agent command setting and General tab from Settings
• Filter worktree variant from pane command palette
• Shrink terminal icon to match agent circle size
• Add single-pane hover overlay, remove UI test target, refine sidebar icons
• Reduce sidebar status circles and indentation for cleaner look
• Add 2x3 grid constraints, improved split/close logic, and command palette for pane creation
• Add worktree name normalization for --name values (#29)
• Add agent variants and command palette for multi-agent support (#30)
• Add pr/reset commands, self-awareness module, and enhanced cleanup
• Add tabbed Settings UI with AppSettingsManager (#28)
• Optimize threading and reduce main-thread contention in dashboard (#23)
• Optimize terminal rendering and memory for multi-agent views (#24)
• Fix stale sidebar node model data when contentSignature is unchanged (#27)
• Fix tmux send-keys not submitting Enter to Claude Code agents (#25)
• Fix spawn/restart opening unwanted Terminal.app windows (#26)
• Incremental sidebar tree updates instead of full rebuild (#22)
• Replace polling with FSEvents file watching for manifest (#21)

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.1.9

Changelog

• Fix tmux not found in dashboard TerminalPane and Terminal.app on M-series Macs
• Fix tmux/git command not found on M-series Macs
• Add CLI version check and bump marketing version to 0.1.8

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.1.8

Changelog

• Build universal binary (x86_64 + arm64) for dashboard .dmg
• Restore Info.plist build file exception to fix .dmg launch
• Remove stale Info.plist build exception from Xcode project
• Separate agent prompt files from reusable prompts, bump 0.1.8
• Add Swarms & Prompts navigation views with sidebar nav rows
• Replace grid focus border with top-edge accent bar, fix focus tracking
• Restore leading padding in grid cells, fix focus border z-order
• Hide TerminalPane status label header
• Remove leading padding in grid pane cells
• Save grid layout after every mutation, not just on suspend
• Persist grid split layout (directions + ratios) across reboots
• Persist grid pane agents/terminals across reboots
• Add per-entry grid persistence and fix navigation/duplicate issues
• Fix cached terminal leak on pane close and nested split focus navigation
• Add multi-pane split views for dashboard terminal grid
• Address review feedback: incremental manifest writes, user var precedence
• Address CodeRabbit review: null-safe YAML parsing, JSON output, and cleanup
• Fix isolated swarm branch collisions and list swarm name display
• Sanitize swarm template and name inputs to prevent path traversal
• Add swarm templates — predefined multi-agent workflows
• Address review feedback: fix heatmap math, throttle cache, and nitpicks
• Add home dashboard with commit heatmaps and project overview
• Fix release notes: correct npm package name and filter infra commits

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.1.7

Changelog

• Add GitHub-style diff viewer with per-file cards
• Add Sparkle 2 auto-update for dashboard app
• Add worktree detail view with action buttons and unstaged diff viewer
• Fix setup screen: correct npm package name and use solid background

Install

# CLI
npm install -g pure-point-guard

# Dashboard app
ppg install-dashboard

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

PPG CLI 0.1.5

PPG CLI Dashboard for macOS

The desktop dashboard gives you a visual control center for your parallel agent workflows — monitor status, view logs, and manage worktrees from a native macOS app.

Install via CLI

You can also install the dashboard directly from ppg:

ppg install-dashboard

---

Changes

Full Changelog: v0.1.4...v0.1.5