# Introduction

`altoviz` is a self-contained command-line interface that wraps the [Altoviz REST API](../api/). It lets you manage customers, suppliers, invoices, quotes, products, receipts, and more — directly from the terminal or from an LLM agent.

**Key highlights:**

- **No runtime required** — single binary for macOS, Linux, and Windows
- **9 output formats** — table (default), JSON, YAML, Markdown, CSV, TSV
- **Shell completions** — bash, zsh, fish, PowerShell
- **Flexible auth** — env var, config file, or `--api-key` flag
- **Scriptable** — pipe JSON in with `--file -`, control columns with `--columns`, page with `--all-pages`

## Quick start

```sh
# Store your API key
altoviz configure

# — or pass it via environment variable
export ALTOVIZ_CLI_API_KEY=your_key_here

# Verify connectivity
altoviz hello

# List invoices
altoviz invoice list

# Fetch a single customer as JSON
altoviz customer get 42 --output json

# Export this year's invoices to CSV
altoviz export invoices --from 2026-01-01 --to 2026-12-31
```

## Next

- [Installation](cli/installation)
- [Configuration](cli/configuration)
- [Commands](cli/commands)
- [Reference](cli/reference)

## Any question?

If you have any question regarding the CLI, feel free to [contact us](https://altoviz.com/contact) by chat or by email.