@runtypelabs/cli 1.4.0 → 1.5.0

package/README.md

@@ -88,6 +88,55 @@ runtype marathon "Code Builder" --goal "Build the payments integration" \
   --max-sessions 20 --track --name "payments"
 ```
 
+#### Customizing the Runner Animation
+
+The marathon header displays an animated runner that laps around the border. You can customize the emojis:
+
+```bash
+# Custom runner and finish line emojis
+runtype marathon "Code Builder" --goal "Build it" --runner-char 🚀 --finish-char 🌕
+
+runtype marathon "Code Builder" --goal "Build it" --runner-char 🏎️ --finish-char 🏆
+
+# Hide the runner, the finish line, or both for a clean border
+runtype marathon "Code Builder" --goal "Build it" --no-runner
+runtype marathon "Code Builder" --goal "Build it" --no-runner --no-finish
+```
+
+| Flag                   | Default | Description                                       |
+| ---------------------- | ------- | ------------------------------------------------- |
+| `--runner-char <char>` | 🏃      | Emoji for the runner                              |
+| `--finish-char <char>` | 🏁      | Emoji for the finish line                         |
+| `--no-runner`          |         | Hide the runner emoji from the header border      |
+| `--no-finish`          |         | Hide the finish line emoji from the header border |
+
+#### Tool Context Modes
+
+When a marathon runs multiple sessions, tool call/result pairs from previous sessions are preserved in the conversation history. The `--tool-context` flag controls how older tool results are stored to balance cost and re-readability:
+
+| Mode                 | Behavior                                                                                                                            | Best for                                                     |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `hot-tail` (default) | Older results offloaded to `.runtype/marathons/{task}/tool-outputs/` with a file path reference. Model can re-read via `read_file`. | Multi-session tasks that may need to revisit earlier results |
+| `observation-mask`   | Older results replaced with `[Output from X masked — re-run the tool if needed]`. No disk I/O.                                      | Cost-sensitive or focused tasks                              |
+| `full-inline`        | All results stay inline forever. No compaction.                                                                                     | Short tasks, debugging, baseline comparisons                 |
+
+The `--tool-window` flag controls which results are "hot" (inline) vs "cold" (compacted):
+
+- `session` (default): Current session's results stay inline; all previous sessions' results are compacted.
+- A number (e.g. `10`): Keep the last N tool result messages inline regardless of session boundaries.
+
+```bash
+# Default: hot-tail mode with session-based compaction window
+runtype marathon "Code Builder" --goal "Fix the bug"
+
+# SWE-agent style: mask old results, keep last 10 inline
+runtype marathon "Code Builder" --goal "Fix the bug" \
+  --tool-context observation-mask --tool-window 10
+
+# Everything inline, no compaction (short tasks or debugging)
+runtype marathon "Code Builder" --goal "Fix the bug" --tool-context full-inline
+```
+
 ## Chat Commands
 
 During a chat session, you can use these special commands:
@@ -247,6 +296,15 @@ pnpm test:watch
 - `RUNTYPE_DEFAULT_MODEL` - Default AI model (default: gpt-4o)
 - `RUNTYPE_DEFAULT_TEMPERATURE` - Default temperature (default: 0.7)
 - `DEBUG` - Enable debug mode
+- `RUNTYPE_DEV_PLAN_OVERRIDE` - JSON string to override billing/plan limits in development. Injects the `X-Dev-Plan-Override` header into all API requests. Only effective when the API runs with `ENVIRONMENT=development`. Example:
+
+  ```bash
+  # Simulate enterprise (unlimited)
+  export RUNTYPE_DEV_PLAN_OVERRIDE='{"scenarioId":"unlimited","plan":"enterprise","overrides":{}}'
+
+  # Simulate slow mode
+  export RUNTYPE_DEV_PLAN_OVERRIDE='{"scenarioId":"slow","plan":"trial","overrides":{"inSlowMode":true,"hourlyUsed":9,"hourlyLimit":10,"hourlyResetSeconds":600}}'
+  ```
 
 ## License