Skip to main content

​
yc-bench run

Execute a complete YC-Bench simulation run with customizable parameters for initial funding, prestige, time limits, and output options.

​
Usage

yc-bench run [OPTIONS]

​
Parameters

​
--initial-funds
number
Starting capital in dollars. Defaults to $50,000.
​
--initial-prestige
number
Starting prestige score. Affects available tasks and hiring options. Defaults to 0.
​
--max-ticks
number
Maximum simulation ticks (time steps) before auto-termination. No default limit.
​
--max-days
number
Maximum simulation days before auto-termination. No default limit.
​
--output
string
Path to save final simulation state as JSON file.
​
--verbose
boolean
Enable detailed logging output during simulation.

​
Response

Returns JSON with the final simulation state:
​
currentTick
number
Final tick number reached
​
currentDate
string
Final simulation date (ISO 8601 format)
​
company
object
Final company state including funds, prestige, employees, and tasks
​
market
object
Final market state with available tasks
​
events
array
Log of all simulation events that occurred

​
Example

# Run with custom initial conditions
yc-bench run --initial-funds 100000 --initial-prestige 10 --max-days 90

# Run and save output to file
yc-bench run --output ./results.json --verbose
Example Output
{
  "currentTick": 2160,
  "currentDate": "2024-04-01T00:00:00.000Z",
  "company": {
    "funds": 75000,
    "prestige": 15,
    "employees": [...],
    "tasks": [...]
  },
  "market": {
    "availableTasks": [...]
  },
  "events": [...]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us