> ## 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`     | `-m`  | `"Pushed from Openlayer CLI"` | Add a commit message to describe this push.                                                           |
| `--wait`        | `-w`  | `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)