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

   curl -fsSL https://twin.igot.ai/installer.sh | bash

   For a non-interactive install:

   curl -fsSL https://twin.igot.ai/installer.sh | bash -s -- --yes

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: