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

<div style="display: flex; gap: 2.5rem; align-items: center; flex-wrap: wrap; margin-block: 1.5rem;">
  <a href="github.com/altoviz/homebrew-tap" target="_blank" rel="noopener">
    <Image
      src={homebrewLogo}
      alt="Homebrew"
      style="height: 64px; width: auto;"
    />
  </a>
  <a
    href="https://community.chocolatey.org/packages/altoviz"
    target="_blank"
    rel="noopener"
  >
    <Image
      src={chocolateyLogo}
      alt="Chocolatey"
      style="height: 64px; width: auto;"
    />
  </a>
  <a
    href="https://winstall.app/apps/Altoviz.CLI"
    target="_blank"
    rel="noopener"
  >
    <Image src={wingetLogo} alt="winget" style="height: 64px; width: auto;" />
  </a>
</div>

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