suya sim

suya sim submits simulations to Subaya’s cloud toolchains and lets you inspect the results. Heavy simulators run on the backend — you pay only for the compute seconds you use. For a worked example, see the Simulation guide and the Quickstart.

suya sim run

Pack your source, ship it to a cloud run, and (optionally) wait for the result.

suya sim run \
  --tool ryusim \
  --tb tb/adder_tb.py \
  --top adder \
  --source ./rtl \
  --wait

Flag	Description
--tb <path>	Testbench path.
--top <module>	Top-level module under test.
--project <id>	Project to run under. Defaults to .subaya/config.toml.
--source <dir>	Source directory to pack and ship with the run.
--tool <name>	Simulator: ryusim, verilator, icarus, questa, xsim, or renode.
--tier <S>	Compute tier for the run.
--wait	Poll until the run reaches a terminal state and print a pass/fail summary.
--no-cache	Force a fresh run, bypassing cached results.
--arg <a>	Extra argument passed through to the simulator. Repeatable.

suya sim list

List your recent runs.

suya sim list

suya sim report

Show a run’s status and a results summary.

suya sim report <run-id>

suya sim logs

Tail a run’s log.

suya sim logs <run-id>
suya sim logs <run-id> --follow

Flag	Description
--follow	Stream the log live until the run finishes.

suya sim rerun

Resubmit a run’s source and spec as a fresh run.

suya sim rerun <run-id>
suya sim rerun <run-id> --wait

Flag	Description
--wait	Poll until the new run reaches a terminal state.

suya sim wave

Locate the waveform artifact for a run, ready to hand off to the wf waveform tool.

suya sim wave <run-id>

See also

• Simulation guide — end-to-end walkthrough.
• suya project — set up the project a run belongs to.
• CLI overview — global flags such as --json for scripting.