# amfelt add job

Add a job to the project configuration.

## Usage

```text
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 |
{.clidoc-flags-table}

## 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 |
{.clidoc-flags-table}

---

Generated from `amfelt` v5.6.3.