Skip to content

CLI reference

gapline is a single binary with several sub-commands. Each one has its own reference page covering every flag, argument, and exit code.

gapline [--config PATH] [--no-color | --force-color] [--threads N] <subcommand> [ARGS]

See global flags for the options accepted by every sub-command.

CommandPurpose
validateRun the full GTFS Schedule validation suite on a feed.
readQuery records from a GTFS file with a SQL-like --where clause.
createInsert new records into a GTFS file.
updateUpdate matching records, with optional cascade to dependent files.
deleteRemove matching records, cascading to dependents when necessary.
runExecute a batch of commands from a .gl script.
rulesList or inspect validation rules registered with this build.
completionGenerate or install a shell completion script.
  • Flags written --name are long form. When a short form exists, it is shown next to the long form.
  • PATH, QUERY, LEVEL, and so on are placeholders for the value the flag expects.
  • Code blocks use $ to mark interactive shell prompts. Output lines have no prompt.
  • Exit codes are documented on concepts/exit-codes; command pages link to the codes they can emit.