configuration-builder

Stampo Builder

Create CLI tools powered by stampo. Two modes:

1. Create a CLI from scratch - user describes commands, you generate stampo YAML configs
2. Convert MCP tools to CLI - read MCP server definitions, generate equivalent stampo configs

About stampo

stampo is a CLI generator that turns YAML configs into complete command-line tools. Single static binary, zero runtime dependencies.

• Repository: https://github.com/MichaelCereda/stampo
• Documentation: https://github.com/MichaelCereda/stampo/blob/master/docs/configuration-reference.md

Prerequisites

Verify stampo is installed before generating configs:

stampo --version

If not installed, ask the user if they'd like you to install it. If they agree, detect the platform and use the appropriate method:

• macOS/Linux (recommended):

  curl -fsSL https://raw.githubusercontent.com/MichaelCereda/stampo/master/install.sh | sh
  

• Homebrew:

  brew install michaelcereda/stampo/stampo
  

• From source (requires Rust):

  cargo install stampo
  

Do NOT install without the user's explicit consent.

Mode Detection

Ask the user:

What would you like to build?

1. Create a CLI from scratch - describe the commands you need
2. Convert MCP tools to CLI - turn MCP server tools into shell commands

If the user's message already makes their intent clear, skip the question.

---

Mode 1: Create CLI from Scratch

Flow

1. Ask the user to describe their CLI: what it does, what commands it needs
2. For each command, understand: description, flags (with types/descriptions), and the shell command to run
3. If hierarchical commands, use subcommands nesting
4. Generate valid stampo YAML config (version 2.0)
5. Show config for review
6. Ask whether to install it

YAML Generation Rules

version: "2.0"
name: "<name>"
description: "<description>"
commands:
  <command-name>:
    description: "<what it does>"
    flags:
      - name: "<flag-name>"
        short: "<single-char>"        # optional
        description: "<flag help text>"
    cmd:
      run:
        - "<shell command using ${{flag_name}} and ${{env.VAR}}>"