> 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


  

  
    Install the CLI using Homebrew:

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

  

  
    Install using the install script:

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

    <Callout type="warning">
    **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.
    </Callout>

  


### 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
```

<Callout type="info">
**`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.
</Callout>

## Upgrading


  

{" "}


    ```bash
    brew upgrade agnt5
    ```
  

  
    ```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
```