Build applications with
humans and AI Agents

# 1. Agent connects to TLL OS, reads Application Graph
$ tll graph read
→ 16 nodes, 14 edges, 2 modules

# 2. Agent discovers available capabilities
$ tll capability list
→ product_catalog, payment, authentication, ...

# 3. Agent creates a new Module
$ tll module create inventory
→ Module "inventory" registered in Graph

# 4. Agent creates API endpoints
$ tll api create --module inventory --path /api/items --method GET
$ tll api create --module inventory --path /api/items --method POST

# 5. Agent creates data models
$ tll model create --module inventory Item --fields sku,name,quantity

# 6. Agent writes and runs tests
$ tll test run --module inventory
→ 8/8 passed

# 7. Agent finds a bug, fixes it, re-tests
$ tll test run
→ 7/8 passed, 1 failed
$ tll fix --test api.item_crud
$ tll test run
→ 8/8 passed

# 8. Agent builds for target platform
$ tll build --target web
→ Build successful: dist/web/

# Install TLL OS CLI
$ npm install -g @tll/os-cli

# Create a new application
$ tll new my-app
✓ Created application "my-app"
✓ Application Graph initialized
✓ Runtime adapter: node

# Enter the project
$ cd my-app

# Create a module
$ tll module create hello
✓ Module "hello" registered
✓ Graph updated: +3 nodes, +2 edges

# Add an API endpoint
$ tll api create --module hello --path /api/hello --method GET --handler "return { message: 'Hello TLL OS' }"
✓ API endpoint created
✓ Graph updated: +1 node, +1 edge

# Run tests
$ tll test
→ 3/3 passed

# Start development server
$ tll serve
→ TLL OS running at http://localhost:3000
→ GET /api/hello → { "message": "Hello TLL OS" }

# Install Shopify Adapter
$ tll adapter install shopify

# Configure connection
$ tll adapter configure shopify \
    --store mystore.myshopify.com \
    --token shpat_xxxxxxxxxxxx

# Connect and read data into Application Graph
$ tll adapter connect shopify
→ Connected to Shopify (API version 2024-07)
→ Synced: 142 products, 89 orders, 234 customers
→ Graph updated: +465 nodes, +892 edges

# Now TLL OS agents can work with your Shopify data
$ tll graph query --type model --name Product
→ 142 Product nodes found

# Or migrate to native TLL OS module
$ tll adapter migrate shopify --entity Product --target-module catalog
→ Migrated 142 products to module:catalog
→ Generated models, APIs, tests
→ 8/8 tests passed