> ## Documentation Index
> Fetch the complete documentation index at: https://openlayer.com/docs/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](/docs/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?](/docs/guides/gh-actions)
* [How can I use the Openlayer CLI for the development mode workflow?](/docs/guides/cli-push)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.