Docs
amfelt add job
Add a job to the project configuration.
Usage
amfelt add-job [name] [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--exclude | string | — | object exclusion glob(s) for a select job; comma-separated |
--force | bool | false | ignore warnings and errors |
--history-mode | string | scd2 | history table accumulation strategy; one of scd2, snapshot, append, scd1 |
--include | string | — | object selection glob(s) over the source contract for a select job; comma-separated (default *) |
--layer | string | all | pipeline layer to deploy; one of staging, history, bridge, business, all |
--path | string | amfelt.yaml | path of the Amfelt project file |
--schedule | string | — | cron schedule for the select job’s run; empty means manual/dispatch-triggered |
--schema-prefix | string | — | base schema prefix override (e.g. “myproject” → myproject_stg, myproject_hst); overrides the PCF’s job.schemaPrefix, falls back to “amfelt” if neither is set |
--source | string | — | name of the source (must match a sources[].name in the project file) |
--strategy | string | full | replication strategy for a select job; one of full, incremental, cdc |
--target | string | — | name of the target (must match a targets[].name in the project file) |
--write-mode | string | — | write mode recorded for the job; one of append, upsert, replace. The agent does not apply it, because the staging layer is always replaced (truncate and reload) on every run. Leave this unset; use historyMode to control append or merge behavior at the history layer |
Global flags
| Flag | Type | Default | Description |
|---|---|---|---|
--amfelt-dir | string | .amfelt | directory for workspace files (such as plugins); does not move agent identity (controlled by AMFELT_DIR) |
--config | string | — | directory or filename of the application configuration |
-f, --format | string | default | log format to use; either default, pretty, or json |
-l, --level | string | info | minimum log level to display; either error, warn, info, or debug |
-v, --verbose | bool | false | trigger to use verbose logging |
Generated from amfelt v5.6.3.
Last updated on November 1, 2026