Projects, workflows, runs
Everything in wfnexus lives in a hierarchy: a project (a repository with .wfx/workflows/)
holds workflows, and a workflow holds runs. There are no global lists of runs, and there
is no builder at the top level. The UI is a drill-down, and each level is one hash route in
apps/ui/src/App.tsx:
| Route | What you see |
|---|---|
#/projects |
Every project, its category, and its workflows and run activity. |
#/projects/:p |
One project’s workflows. |
#/projects/:p/+new |
Start a workflow in this project. |
#/projects/:p/:w |
One workflow: its steps and recent runs. |
#/projects/:p/:w/edit |
Edit it. When the project is a git repo, the save becomes a proposal. |
#/projects/:p/:w/run |
Start a run with its inputs. |
#/projects/:p/:w/runs/:id |
One run, step by step, with the agent’s tool calls streamed live over SSE. |
The top navigation also has Templates, Skills & tools, Workers and System.
The same thing from the CLI
Section titled “The same thing from the CLI”wfx projects # every project: workflows and run activitywfx project add ~/code/api --as api --category developmentwfx workflows # list workflowswfx workflows show <name> # every step's harness: skills, tools, team, budget, gateswfx runs --project api --workflow nightly # recent runs, newest firstwfx show <run-id> # a run, step by stepwfx logs <run-id> -f # the activity logwfx retry <run-id> --step <id> # re-run from a stepwfx cancel <run-id>Categories
Section titled “Categories”A project says what kind of work it does. wfx project categories lists the ids and
wfx project set <name> --category <id> sets one. There are 17 of them, defined in
internal/workflow/categories.go: development, debugging-ops, security, data, product-design,
support, sales, marketing, finance, legal, hr, operations, healthcare, research, education,
public-sector and general.