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

# Quickstart

> Authenticate, choose an agent, and run it from the CLI.

The CLI is the fastest way to exercise the same API your application will use. It requires Node.js 20 or newer.

## 1. Install and authenticate

```bash theme={null}
npm install --global @fluenterp/cli
fluent auth login
fluent auth status
```

`fluent auth login` opens a browser and uses OAuth with PKCE. For CI or another unattended environment, set a dedicated API key instead:

```bash theme={null}
export FLUENT_API_KEY="fl-..."
```

See [Authentication](/docs/guides/authentication) for credential and scope details.

## 2. Find an agent

```bash theme={null}
fluent agents list
```

The output includes each accessible agent's ID, name, and description. Agent names are accepted by `runs create` when the name is unique.

## 3. Start a run

Run an agent with a document:

```bash theme={null}
fluent runs create \
  --agent "Accounts Payable" \
  --file invoice.pdf \
  --wait
```

Or run an agent with a text instruction:

```bash theme={null}
fluent runs create \
  --agent "Operations" \
  --message "Summarize our open issues" \
  --wait
```

Without `--wait`, the command returns immediately with a run ID and status URL. Use that ID to inspect or follow the run:

```bash theme={null}
fluent runs get "$RUN_ID"
fluent runs watch "$RUN_ID"
```

## 4. Use structured output

Every resource command supports `--json`, which is the stable interface for scripts:

```bash theme={null}
fluent runs create \
  --agent "$AGENT_ID" \
  --file invoice.pdf \
  --wait \
  --json
```

<Tip>
  A watched run exits nonzero when its final status is `failed` or `cancelled`, so CI jobs fail naturally.
</Tip>