Skip to main content

Documentation Index

Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Manage the results directory produced by momentic run. Use upload after running with --upload-results disabled, merge to combine sharded runs, and view to inspect runs locally without uploading.
npx momentic results upload

upload

Upload local test results to the Momentic dashboard.
npx momentic results upload [folder]

Arguments

[folder]
string
Folder containing results from momentic run or momentic results merge. Defaults to test-results, which matches the default --output-dir of momentic run, so you can usually omit this argument.

merge

Merge results from multiple sharded runs into a single folder before uploading.
npx momentic results merge <parent folder>

Arguments

<parent folder>
string
required
Parent folder of the results to merge. For example, if shards wrote into test-results/shard-1 and test-results/shard-2, pass test-results.

Options

--output-dir <outputDir>
string
Directory to write the merged results to. The folder is overwritten if it exists.

view

Launch the local run viewer to inspect results without uploading.
npx momentic results view <results> [runId]

Arguments

<results>
string
required
Path to a folder containing a runs/ subfolder. Defaults to test-results.
[runId]
string
Run ID to open, matching a zip file in the runs/ subfolder. For example, for runs/eed92602-7355-43dc-8d79-1c43029bec26.zip, pass eed92602-7355-43dc-8d79-1c43029bec26. When omitted, the viewer opens to the run group table.

Options

--port <port>
number
Port for the local run viewer server. Defaults to 58889.

Examples

Upload the default results folder:
npx momentic results upload
Merge sharded results before uploading:
npx momentic results merge test-results --output-dir test-results/merged
npx momentic results upload test-results/merged
View a specific run locally on a custom port:
npx momentic results view --port 59999 my-results eed92602-7355-43dc-8d79-1c43029bec26