@runtypelabs/cli 0.1.10 → 0.2.1

package/README.md

@@ -10,6 +10,12 @@ Command-line interface for the Runtype AI platform.
 npm install -g @runtypelabs/cli
 ```
 
+Or run without installing:
+
+```bash
+npx @runtypelabs/cli <command>
+```
+
 ## Quick Start
 
 ### 1. Create Account & Authenticate
@@ -54,6 +60,34 @@ runtype records create --name "My Record" --type "document"
 runtype records list --type document
 ```
 
+### 4. Run Multi-Session Agent Tasks
+
+Use `runtype marathon` (or `runtype agents task`) to run long-running, multi-session agent tasks with real-time streaming output.
+
+```bash
+# Run a task — agent output streams to your terminal in real time
+runtype marathon "Code Builder" -m "Refactor the auth module to use JWT tokens"
+
+# Set a budget and session limit, save progress with a custom name
+runtype marathon agent_abc123 -m "Write integration tests for the API" \
+  --max-sessions 10 --max-cost 2.50 --name "api-tests"
+
+# Override the agent's configured model
+runtype marathon "Code Builder" -m "Build a calculator" --model claude-sonnet-4-5
+
+# Enable sandboxed code execution tooling for the task (QuickJS or Daytona)
+runtype marathon "Code Builder" -m "Compute totals from this dataset" --sandbox quickjs
+runtype marathon "Code Builder" -m "Generate a script and run it" --sandbox daytona
+
+# Resume an interrupted task (picks up where it left off)
+runtype marathon "Code Builder" -m "Refactor the auth module to use JWT tokens" \
+  --resume --name "auth-refactor" --debug
+
+# Sync progress to a Runtype record (visible in the dashboard)
+runtype marathon "Code Builder" -m "Build the payments integration" \
+  --max-sessions 20 --track --name "payments"
+```
+
 ## Chat Commands
 
 During a chat session, you can use these special commands: