> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# push

> Push the current local directory to the Openlayer project

The `openlayer push` command is used to push the current local directory to the
Openlayer project [linked](/api-reference/cli/commands/link).

## Usage

```bash theme={null}
openlayer push [flags]
```

### Examples

```bash theme={null}
# Push with a commit message
openlayer push --message "Initial experiment with smaller model"

# Push without waiting for results
openlayer push --wait=false

# Push and stream logs in real time
openlayer push --tail

# Push with custom arguments passed to your batch command – these will get logged in the commit
openlayer push --custom-args learning_rate=0.01,batch_size=32
```

## Flags

| Flag            | Alias | Default | Description                                                                                           |
| --------------- | ----- | ------- | ----------------------------------------------------------------------------------------------------- |
| `--message`     |       | `""`    | Add a commit message to describe this push.                                                           |
| `--wait`        |       | `true`  | Wait until tests finish running before returning.                                                     |
| `--tail`        | `-t`  | `false` | Stream live logs and progress updates while the push runs.                                            |
| `--custom-args` |       | `""`    | Comma-separated list of `key=value` arguments. Overrides any custom args defined in `openlayer.json`. |

## Related guides

* [How can I use GitHub Actions with Openlayer?](/guides/gh-actions)
* [How can I use the Openlayer CLI for the development mode workflow?](/guides/cli-push)