Quick Start

Use this page when you only need the shortest path: install OSTwin, create a plan.md markdown file, then start the work.

1. Install OSTwin

   installer_file="$(mktemp)"
   trap 'rm -f "$installer_file"' EXIT
   curl --proto '=https' --tlsv1.2 -fsSL \
     https://twin.igot.ai/installer.sh -o "$installer_file"
   chmod 0700 "$installer_file"
   # Inspect and verify the downloaded file before execution.
   export OSTWIN_INSTALLER_VERSION=v1.0.0 # Replace with the approved tag.
   bash "$installer_file"

   For a non-interactive install:

   bash "$installer_file" --yes

   For controlled deployments, pin a tagged release and verify its checksum and approved provenance against an independently obtained release manifest.

2. Create plan.md

   mkdir -p test-project-xipat
   cd test-project-xipat
   
   cat > plan.md << 'EOF'
   # Qualification Form in Shopify New Customer Accounts
   
   ## Config
   provider: anthropic
   model: claude-sonnet-4-20250514
   
   ## Goal
   Build a Shopify new customer account qualification form that collects
   business details, validates required fields, and routes the submission
   into a review workflow.
   
   ## Epic 1: Qualification Form UI
   Roles: engineer, qa
   
   ### Definition of Done
   - Customer account page shows the qualification form
   - Form captures business name, tax ID, contact email, and review notes
   
   ### Acceptance Criteria
   - Required fields block submission when empty
   - Valid submissions show a confirmation state
   - Form state is testable locally
   
   ### Tasks
   - TASK-001: Add the customer account form UI
   - TASK-002: Implement validation and submit handling
   - TASK-003: Add tests for required fields and success state
   EOF

Start The Work

Create the plan record, then launch it:

$ ostwin plan create plan.md
✓ Plan created: f055e125de07
  Title:  Qualification Form in Shopify New Customer Accounts
  Dir:    /Users/xxxx/Downloads/test-project-xipat
  Source: plan.md
  Editor: http://localhost:3366/plans/f055e125de07

$ ostwin run f055e125de07

The editor shows the plan flow as a dependency graph: