Custom Workflows

Integrate Perspt into scripts, CI/CD pipelines, and automation.

Simple CLI for Scripting

The simple-chat command provides a Unix-friendly interface:

# Interactive
perspt simple-chat

# With session logging
perspt simple-chat --log-file session.txt

Batch Agent Runs

Run multiple agent tasks from a script:

#!/bin/bash
set -e
export GEMINI_API_KEY="your-key"

perspt agent --yes --max-cost 2.0 -w /tmp/proj1 "Create a Python CSV parser"
perspt agent --yes --max-cost 2.0 -w /tmp/proj2 "Create a Rust CLI calculator"

CI/CD Integration

Use headless mode in CI/CD pipelines:

# GitHub Actions example
name: Generate Boilerplate
on:
  workflow_dispatch:
    inputs:
      task:
        description: 'Task description'
        required: true

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Perspt
        run: cargo install perspt
      - name: Run Agent
        env:
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: |
          perspt agent --yes --max-cost 5.0 \
            -w ./generated "${{ inputs.task }}"
      - name: Commit Results
        run: |
          git add generated/
          git commit -m "Generated: ${{ inputs.task }}"

Post-Run Analysis

After an agent run, use the management commands:

# Session status
perspt status

# LLM logs (requires --log-llm during the run)
perspt logs --tui
perspt logs --stats

# Ledger history
perspt ledger --recent
perspt ledger --stats

# Resume incomplete sessions
perspt resume --last