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

# CLI Overview

> Tour of the noorle CLI for managing WASM plugins, agents, MCP gateways, and direct REST calls, with config file and environment variable setup

The Noorle CLI provides command-line tools for managing plugins, agents, and gateways.

## What Can You Do

* **Authenticate** - Login and manage tokens
* **Manage Plugins** - Build, push, list versions
* **Manage Agents** - Create, configure, run
* **Manage Gateways** - List, configure MCP/A2A
* **API Calls** - Direct REST API access

## Installation

[See Installation Guide →](/docs/reference/cli/installation)

## Basic Usage

```bash theme={null}
noorle [COMMAND] [OPTIONS]
```

Common commands:

```bash theme={null}
noorle login                     # Authenticate
noorle plugin new my-plugin      # Create plugin
noorle plugin build              # Build to WASM
noorle plugin push               # Upload
noorle agent list                # List agents
noorle gateway info              # Gateway details
```

## Help

```bash theme={null}
# Overall help
noorle help

# Command help
noorle help plugin
noorle help agent

# Full reference
noorle --version
```

## Authentication

```bash theme={null}
# Login with device flow
noorle login

# Use API key
noorle --api-key YOUR_KEY plugin list

# Set default account
noorle config set account-id YOUR_ACCOUNT_ID
```

## Configuration

CLI config in `~/.noorle/config.toml`:

```toml theme={null}
[defaults]
account_id = "550e8400-..."
gateway_id = "mcp-..."

[auth]
api_key = "ak-..."  # Optional
```

## Environment Variables

```bash theme={null}
NOORLE_API_KEY=ak-...
NOORLE_ACCOUNT_ID=550e8400-...
NOORLE_GATEWAY_ID=mcp-...
```

## Output Formats

```bash theme={null}
# Default: human-readable
noorle plugin list

# JSON
noorle plugin list --json

# Table
noorle plugin list --format table

# YAML
noorle plugin list --format yaml
```

## Next Steps

* [Installation](/docs/reference/cli/installation)
* [Commands Reference](/docs/reference/cli/commands)
* [Workflows](/docs/reference/cli/workflows)