docs: fix traj-to-demo command in demonstrations guide (#1448)

The demonstrations guide documents the conversion command as
`sweagent traj-to-demo --traj_path<path to trajectory file.traj>`, but
copying it verbatim fails argument parsing:

    sweagent: error: the following arguments are required: traj_path

`traj-to-demo` is argparse-based and declares `traj_path` as a positional
argument (sweagent/run/run_traj_to_demo.py), not a `--traj_path` option, so
the `--traj_path` form is unrecognized. The documented string also glues the
flag to the placeholder with no space.

Use the positional form `sweagent traj-to-demo <path to trajectory file.traj>`
so the command runs as written. The following run-replay step is left
unchanged: run-replay is pydantic-settings based and does expose a real
`--traj_path` field.

Signed-off-by: Anas Khan <83116240+anxkhn@users.noreply.github.com>
This commit is contained in:
Anas Khan
2026-07-07 21:26:44 +05:30
committed by GitHub
parent 10ab1a9789
commit 7506615844
+1 -1
View File
@@ -31,7 +31,7 @@ Here's how you can make a demo from an existing trajectory file (like the one cr
1. Find a basic trajectory that you already like and want to use as the basis for your demo.
For instance, consider the `.traj` files in the [`trajectories/demonstrations/` folder](https://github.com/SWE-agent/SWE-agent/tree/main/trajectories/demonstrations)
or find the trajectory from the previous step (the path will be printed at the bottom).
2. Run `sweagent traj-to-demo --traj_path<path to trajectory file.traj>` to convert the trajectory to a demo.
2. Run `sweagent traj-to-demo <path to trajectory file.traj>` to convert the trajectory to a demo.
This demo will be saved as a readable yaml file in the `demos/` directory.
3. Edit the demo by hand to make it work for your particular use case and configuration.
4. (Optional) Run `sweagent run-replay --traj_path <path to demo>` to execute the actions of the demo, have the system generate the execution output, and ensure that it works as expected.