GForm

Appearance

delete ​

Remove form YAML files from the global library only ($GFORM_HOME/forms/). Does not touch cwd ./forms/, run artifacts, or auth.

For one past run/batch artifact (+ its history rows), use run delete / gform run rm. For bulk generated data, use clean.md.

delete one form ​

bash
gform delete                       # TTY: pick a form
gform delete <form>
gform rm <form>                      # short alias
gform delete <form> --yes            # skip confirm

Shows a preview (name, steps, path), then confirms on TTY. --yes / -y required for non-TTY.

delete all library forms ​

bash
gform delete all
gform delete all --yes

Lists every library form, confirms, then removes all. cwd ./forms/ is untouched.

delete a run artifact ​

bash
gform run delete                 # TTY: pick an artifact
gform run delete <id>
gform run rm <id> --yes

Removes that artifact dir, refreshes the artifact index cache, and drops matching history.jsonl rows. Unique / --once / --skip-duplicates will not include deleted artifacts afterward. Full notes: run.md — delete one artifact.

delete vs clean vs run delete ​

commandremoves
gform delete <form>one library form YAML
gform delete allall library form YAMLs
gform run delete <id>one run/batch artifact + its history rows
gform clean artifactsall (or age-filtered) run output dirs
gform clean historyentire dedupe ledger
gform clean authsession profiles

Deleting a form does not delete its past run artifacts — use run delete or clean for those.

gotchas ​

  • Name accepts <form> or <form>.yaml — resolves library basename.
  • Aborted form delete prints: "Use gform clean for artifacts/history/auth."
  • Project-local ./forms/<form>.yaml is never deleted by this command — remove manually or use your file manager.
  • History rows for deleted forms remain in history.jsonl until gform clean history (or run delete for a specific artifact).
  • Top-level gform rm is form delete; gform run rm is artifact delete.