v0.2.0 - Specialized Agent Presets

Specialized Agent Presets

This release adds a presets system for bundling agent configuration, profiles, capabilities, and environment variables into reusable templates.

New Features

• Preset definition system - JSON configuration files in ~/.config/macbox/presets/
• CLI commands - presets list, show, create, edit, delete
• --preset flag for run and shell commands
• Model configuration via agent config files in sandbox home
• Session tracking - presets are recorded and restored on attach
• Bundled presets - fullstack-typescript, python-ml, rust-dev

Example Usage

# List available presets
macbox presets list

# Run with a preset
macbox run --preset fullstack-typescript -- --help

# Shell with a preset
macbox shell --preset python-ml

# Create a custom preset from template
macbox presets create my-preset --template fullstack-typescript

# Edit a preset
macbox presets edit my-preset

Preset Schema

{
  "name": "my-preset",
  "description": "My custom development preset",
  "agent": "claude",
  "model": "claude-sonnet-4-20250514",
  "profiles": ["host-tools"],
  "capabilities": {
    "network": true,
    "exec": true,
    "extraReadPaths": ["/opt/homebrew", "~/.nvm"],
    "extraWritePaths": []
  },
  "env": {
    "NODE_ENV": "development"
  },
  "worktreePrefix": "ai-mypreset",
  "startPoint": "main"
}

Full Changelog

• Add specialized agent presets system
• Add bundled presets: fullstack-typescript, python-ml, rust-dev
• Integrate --preset flag into run, shell, and attach commands
• Track presets in session records for reproducibility
• Update README and USER_GUIDE with presets documentation