> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
last_verified: 2026-07-24
title: CLI overview
category: CLI
description: Command-line interface for developing, testing, and deploying AI workflows locally and in production
hideRightSidebar: true
---


**Binary**: `agnt5`
**Install (macOS)**: `brew install agnt5dev/agnt5/agnt5`
**Install (Linux)**: `curl -LsSf https://agnt5.com/cli.sh | bash`
**Core commands**: `agnt5 create`, `agnt5 dev`, `agnt5 run`, `agnt5 deploy`, `agnt5 inspect`, `agnt5 secrets`, `agnt5 auth`, `agnt5 serverless`
**Config home**: `~/.agnt5/` (credentials, context)
**Full list**: see [All commands](/docs/cli/commands.md)


## Core Commands

- `agnt5 create` / `agnt5 init` - Scaffold a new project or link the current directory
- `agnt5 dev` - Run your worker locally with hot-reload
- `agnt5 run` - Execute a function, workflow, tool, or agent
- `agnt5 deploy` - Build, push, and deploy your project
- `agnt5 inspect` / `agnt5 logs` - Inspect runs, traces, and logs
- `agnt5 secrets` - Manage secrets for a project
- `agnt5 auth` - Log in and check authentication status

See the [full command list](/docs/cli/commands.md) for everything else — evals,
service keys, workspaces, serverless endpoints, and automation commands.

## Installation



**macOS:**

Install the CLI using Homebrew:

```bash
brew install agnt5dev/agnt5/agnt5
```

**Linux:**

Install using the install script:

    ```bash
    curl -LsSf https://agnt5.com/cli.sh | bash
    ```


> **Configure your PATH**
>
> Add the CLI to your PATH after installation:
>
> ```bash
> echo 'export PATH="$HOME/.agnt5/bin:$PATH"' >> ~/.bashrc
> source ~/.bashrc
> ```
>
> Use `~/.zshrc` if you're using zsh instead of bash.



### Verify Installation

```bash
agnt5 --version
```

## Quickstart

```bash
# Scaffold a new project in its own directory
agnt5 create my-workflow
cd my-workflow

# Authenticate and deploy
agnt5 auth login
agnt5 deploy
```


> **`agnt5 create <name>`** makes a new `<name>` directory and scaffolds into it. **`agnt5 init`** does the opposite — it links the *current* directory instead, so `agnt5 init my-workflow && cd my-workflow` fails: no directory is created. Run `agnt5 init` from inside an existing project directory instead.


## Upgrading



**Homebrew:**

```bash
brew upgrade agnt5
```

**CLI:**

```bash
agnt5 version update
```



If neither works (for example, an older binary without the self-update command), re-run the install script — it replaces the binary with the latest version:

```bash
curl -LsSf https://agnt5.com/cli.sh | bash
```