RoboCrunch

Get started

Your first Team

Download and extract the Windows ZIP. Open PowerShell in the extracted folder containing RoboCrunch.Cli.exe. These commands use D:\RoboCrunch as the new workspace; choose another new folder if needed.

Download Windows CLI 0.2.0

1. Create the workspace

.\RoboCrunch.Cli.exe engine init "D:\RoboCrunch"
.\RoboCrunch.Cli.exe engine install media-posts --workspace "D:\RoboCrunch"
.\RoboCrunch.Cli.exe engine blocks --workspace "D:\RoboCrunch"

4M is installed automatically. Media Posts is included as an optional Block, using the same package as its separate download. These commands make no model calls.

2. Select your model

notepad "D:\RoboCrunch\engine.yaml"

Set model to a Responses API model available in your OpenAI project. Leave your key out of this file. The CLI asks for it privately when needed, or reads OPENAI_API_KEY if you already set it in the terminal.

OpenAI API usage is billed to your API account. A ChatGPT subscription is not required. maxApiCalls bounds requests per command; it is not a dollar limit.

3. Try Media Posts

Still in the extracted CLI folder, copy the included example into the workspace and preview its six turns:

Copy-Item ".\Examples\media-posts\Knowledge\robocrunch.md" "D:\RoboCrunch\Knowledge\"
.\RoboCrunch.Cli.exe engine run --workspace "D:\RoboCrunch" --skills media-posts --project first-post --task-file ".\Examples\media-posts\brief.md" --preview

The example describes this CLI. For your own post, use your brief and put the relevant facts in the workspace’s Knowledge folder.

Run the assignment when ready. This makes paid API calls:

.\RoboCrunch.Cli.exe engine run --workspace "D:\RoboCrunch" --skills media-posts --project first-post --task-file ".\Examples\media-posts\brief.md"

One round uses six model calls, plus knowledge embeddings when enabled. The terminal prints each Agent’s progress, the result and saved paths. Open the .result.md file to review the post and editorial note. The full transcript is beside it.

4. Add your knowledge and Blocks

Add Markdown or OKF files under D:\RoboCrunch\Knowledge. Install another Block from a directory, ZIP or direct HTTPS download. Use --teams and --skills to choose the combination for each run.

The download includes the full CLI guide and Block format for writing your own packages.