Press Ctrl+B to toggle sidebar
bash -- completengine
$

> about

Welcome to the completengine developer community. We are building the next generation of concurrent event simulation — an open platform where complex systems can be modeled, tested, and understood.

The engine handles millions of concurrent events with deterministic replay, making it ideal for network simulations, game servers, financial modeling, and distributed systems testing.

Simulation is the new documentation. If your system can be simulated, it can be understood.

Our community drives the engine forward — from core contributions to plugin development, from bug reports to architecture discussions. Every voice matters here.


> features --list

// core capabilities
 1  concurrent_events    Handle 10M+ events/sec
 2  deterministic_replay Reproduce any simulation run
 3  plugin_system        Extend with custom modules
 4  hot_reload           Modify running simulations
 5  distributed_mode     Scale across clusters
 6  time_warp            Fast-forward or rewind state
 7  event_tracing        Full causality chain tracking
 8  snapshot_export      Save/restore simulation state

Each feature is designed with developer experience in mind. The API is clean, the documentation is thorough, and the community is here to help.


$ community --status

@devnull 2h ago

Just shipped a plugin for real-time visualization of event cascades. Check it out at plugins/cascade-viz.

@simrunner 5h ago

Has anyone benchmarked the distributed mode on ARM clusters? Seeing some interesting perf differences vs x86.

@eventloop 1d ago

New RFC posted: deterministic seeding for stochastic simulations. Looking for feedback from the math-inclined folks. #rfc-0042

@coremaintainer 2d ago

v3.2.0 release candidate is up. Main change: event batching now 40% faster. Please test and report any regressions.


$ get-started --quickstart

Get up and running in under a minute:

// installation
 1  # Install via cargo
 2  $ cargo install completengine
 3
 4  # Or clone and build from source
 5  $ git clone https://github.com/completengine/core
 6  $ cd core && cargo build --release
 7
 8  # Create your first simulation
 9  $ completengine init my-sim
10  $ cd my-sim
11  $ completengine run

Your simulation is now running locally. Open http://localhost:8080 to see the dashboard. Edit sim.toml to configure events, timing, and output formats.

Read the full documentation at docs.completengine.net or jump into the #help channel.


> contribute --info

completengine is open source and community-driven. Here is how you can help:

CODE ──── Fix bugs, add features, improve performance. Check the good-first-issue tag.
DOCS ──── Write tutorials, improve API docs, translate content.
TEST ──── Report bugs, write test cases, benchmark on different hardware.
REVIEW ──── Review pull requests, participate in architecture discussions.

All contributions follow our CODE_OF_CONDUCT.md. Be kind, be constructive, be curious.


$ changelog --recent

v3.2.0-rc1 2026-04-01

Event batching rewrite — 40% throughput improvement. New snapshot format. Breaking: plugin API v2 required.

v3.1.4 2026-03-15

Hotfix for distributed mode reconnection. Improved error messages for malformed event schemas.

v3.1.3 2026-02-28

Added time_warp acceleration controls. New plugin hooks for pre/post event processing.

v3.1.0 2026-01-10

Major release: distributed mode, event tracing, and the new plugin system. Community contributed 47 plugins in first week.