worldfork-cli

Drive headless WorldFork social simulations via a synchronous CLI.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Hilo-Hilo/worldfork-cli --skill worldfork-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worldfork-cli
Source: https://github.com/Hilo-Hilo/worldfork-cli/tree/main
Command: npx skills add https://github.com/Hilo-Hilo/worldfork-cli --skill worldfork-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need for a browser frontend or complex Docker stack when working with a WorldFork backend, providing a lightweight command-line client for driving explainable, recursively branching social simulations programmatically.

Core Features & Use Cases

  • Headless Backend Control: Drive the entire simulation lifecycle via the worldfork CLI without any UI.
  • Simulation Management: Create, start, pause, and run Big Bang simulations to completion, including async job tracking.
  • Inspection & Debugging: Inspect multiverse DAGs, universe traces, cohort transcripts, and LLM request logs with verbosity controls to manage context window size.
  • Live Model Routing: Hot-swap LLM models per job type without restarting containers using the worldfork model commands.
  • Use Case: An AI agent or developer needs to run a social simulation, monitor its progress via jobs and logs, and inspect specific actor traces at specific ticks, all from a shell script or coding agent.

Quick Start

Use the worldfork-cli skill to verify the backend is healthy and list all available Big Bang simulations.

Frequently Asked Questions about worldfork-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a social simulation backend from the command line without a browser UI?

To run social simulations programmatically, use a headless CLI client to drive the backend, eliminating the need for a browser frontend or complex Docker stack while managing the entire simulation lifecycle from your shell.

What is the best way to inspect multiverse states and actor traces in a branching simulation?

The best way to inspect multiverse states and actor traces is by using CLI inspection commands with verbosity controls, allowing you to examine universe DAGs, cohort transcripts, and LLM request logs while managing your context window size.

Can I hot-swap LLM models during an active social simulation job?

Yes, you can hot-swap LLM models per job type during an active social simulation without restarting containers by using dedicated model routing commands provided by the CLI client.

How do I track asynchronous simulation jobs and monitor progress in a shell script?

You can track asynchronous simulation jobs and monitor progress in a shell script by utilizing the CLI's built-in async job tracking features, which support starting, pausing, and running Big Bang simulations to completion.

Does the WorldFork CLI require heavy dependencies or Docker containers to operate?

The WorldFork CLI does not require heavy dependencies or Docker containers; it functions as a dependency-light HTTP client designed for synchronous command-line execution and arbitrary query escape hatches.