# Intuizi CLI


<div style="margin-top:0.5rem;margin-bottom:1.5rem;">
{{< hextra/hero-subtitle >}}
  Build, size, and deliver audiences from your terminal.
{{< /hextra/hero-subtitle >}}
</div>

The Intuizi CLI is one small program, `intuizi`. What you do in the Intuizi
console or with API calls, you can do with a command: type it yourself, or put
it in a script or a CI job.

<div style="margin-top:1.5rem;margin-bottom:2rem;">
{{< hextra/hero-button text="Get started" link="/developers/cli/getting-started/" >}}
</div>

## Install

{{< tabs >}}

  {{< tab name="Homebrew" >}}
  ```bash
  brew install intuizi/intuizi-cli/intuizi
  ```
  {{< /tab >}}

  {{< tab name="npm" >}}
  ```bash
  npm install -g @intuizi/cli
  ```
  {{< /tab >}}

  {{< tab name="Download" >}}
  Pick the file for your system on the
  [releases page](https://github.com/intuizi/intuizi-cli/releases) on GitHub.
  {{< /tab >}}

{{< /tabs >}}

Then log in once, with the email and password you use for the Intuizi console:

```bash
intuizi auth login
```

It runs on macOS, Linux, and Windows. [Getting Started](/cli/getting-started)
has the details, including how to use it in CI.

## See it in action

```bash
# Find the brand you want to target
intuizi reference poi brands --search starbucks

# See how many devices the audience would hold, without creating it
intuizi audiences estimate create --type poi --brand starbucks --country USA \
  --start-date 2026-09-02 --end-date 2026-09-09 --name "Starbucks - 1 week" --wait

# Build it, and wait until it is ready
intuizi audiences create --type poi --brand starbucks --country USA \
  --start-date 2026-09-02 --end-date 2026-09-09 --name "Starbucks - 1 week" --wait

# Deliver it to one of your endpoint connections
intuizi activations create --audience-id <id> \
  --endpoint-connection-id <id> --pricing-model-id <id> --datastream <id> --wait
```

Names like `starbucks` are looked up for you, so you rarely need to find an id
first. The [Quickstart](/cli/quickstart) walks through these steps one at a
time.

## What you can do

{{< hextra/feature-grid >}}
  {{< hextra/feature-card
    title="Build audiences"
    subtitle="From real-world behavior: places visited, apps, web and CTV activity, purchases, and more. Use brand and category names instead of ids."
    link="/developers/cli/reference/audiences/"
  >}}
  {{< hextra/feature-card
    title="Size before you build"
    subtitle="Estimate how many devices an audience would hold, without creating it."
    link="/developers/cli/reference/audiences/#estimate-create"
  >}}
  {{< hextra/feature-card
    title="Deliver"
    subtitle="Send an audience to your destinations: all of it, or only the devices seen on several days."
    link="/developers/cli/reference/activations/"
  >}}
  {{< hextra/feature-card
    title="Bring your own data"
    subtitle="Import your customer lists as cohorts, and submit your own locations."
    link="/developers/cli/reference/cohorts/"
  >}}
  {{< hextra/feature-card
    title="Keep it fresh"
    subtitle="Rebuild an audience every day, week, or month on a schedule."
    link="/developers/cli/reference/schedules/"
  >}}
  {{< hextra/feature-card
    title="Script it"
    subtitle="JSON output, ids alone, and clear exit codes, for scripts and CI pipelines."
    link="/developers/cli/reference/#conventions"
  >}}
{{< /hextra/feature-grid >}}

## CLI, API, or MCP?

All three query the same [Large Behavioral Model](/concepts/large-behavioral-model),
with the same rules and limits:

- **CLI** - for people at a terminal, and for scripts and CI jobs.
- **[API](/api/v2)** - for your own code and integrations.
- **[MCP Server](/mcp)** - for AI agents.

Every CLI command uses the documented API endpoints, so whatever works in the
CLI works in the API too.

## Next steps

{{< cards cols="2" >}}
  {{< card link="/developers/cli/getting-started/" title="Getting Started" icon="play" subtitle="Install, log in, and run your first command." >}}
  {{< card link="/developers/cli/quickstart/" title="Quickstart" icon="lightning-bolt" subtitle="Find a brand, build an audience, and deliver it." >}}
  {{< card link="/developers/cli/reference/" title="Command Reference" icon="book-open" subtitle="Every command and flag, and the endpoint behind it." >}}
  {{< card link="https://github.com/intuizi/intuizi-cli" title="GitHub" icon="github" subtitle="Source code, releases, and bug reports." >}}
{{< /cards >}}