@goldensheepai/shep-cli

The CLI for ShepLang — compile, verify, and deploy Shep specifications.

Installation

npm install -g @goldensheepai/shep-cli

Quick Start

# Create a new ShepLang project
shep new my-app
cd my-app

# Let AI write your spec
shep draft "A task manager with priorities and due dates"

# Compile to Python + TypeScript + SQL
shep compile --input app.shep --output generated

# Verify without generating
shep verify app.shep

Commands

shep new <name>

Creates a new ShepLang project with starter files.

shep new my-saas-app

shep draft "<description>"

Uses AI to generate a ShepLang spec from a natural language description.

shep draft "An e-commerce store with products, cart, and checkout"

shep compile

Compiles a .shep file to production-ready code.

shep compile --input app.shep --output generated

Output:

• backend/ — Python (FastAPI + Pydantic)
• frontend/ — TypeScript (React + types)
• schema.sql — PostgreSQL schema
• auth.py — JWT authentication
• admin.html — Admin dashboard

shep verify

Validates a spec without generating code.

shep verify app.shep
shep verify app.shep --strict   # Treat warnings as errors
shep verify app.shep --json     # JSON output

shep style

Applies styling improvements (Tailwind, shadcn/ui).

shep style --input generated/frontend

shep deploy

Generates deployment configs for Railway, Render, Fly.io, Vercel.

shep deploy --platform railway

Example

app "SupportTickets"

data Ticket {
  title: text (required)
  message: text
  sentiment: ai("classify as positive, neutral, negative")
}

action EscalateTicket {
  if ai(message, "sounds frustrated") {
    set status = escalated
    alert on-call
  }
}

shep compile --input support.shep --output generated

Related Packages

• @goldensheepai/shep-core — Parser & verifier
• @goldensheepai/shep-sheplang — TypeScript codegen
• @goldensheepai/shep-shepthon — Python codegen
• @goldensheepai/shep-lsp — Language Server

License

MIT © Golden Sheep AI