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

# Introduction

> Use the Maito CLI to work with posts, newsletter resources, social destinations, queue items, and account settings from a terminal.

The Maito CLI is for people and AI agents that need a direct terminal interface to Maito. Use it to create, schedule, and publish social posts, manage newsletter subscribers and issues, and inspect queue items without opening the hosted app.

The CLI is a regular command-based interface. It does not expose a generic REST passthrough. Every supported operation is available as a named command such as `maito posts list`, `maito posts create`, or `maito newsletter subscribers list`.

## When To Use It

Use the CLI when you want to:

* Run Maito actions from scripts, CI jobs, or local automation.
* Let an AI coding agent inspect or update Maito resources through predictable commands.
* Work with newsletter subscribers, issues, segments, and analytics.
* Publish, schedule, retry, or inspect social and newsletter work from the terminal.

For direct HTTP integrations, use the [API](/docs/api-reference/introduction).

## Command Shape

Commands use resource-action names:

```sh theme={null}
maito <resource> <action> [options]
```

Examples:

```sh theme={null}
maito posts list --limit 10
maito posts create --body "Launch note" --platform linkedin
maito newsletter subscribers list --limit 25 --json
```

Most commands return human-readable output by default. Add `--json` when another tool or script needs the raw response.

## Auth

Sign in for full CLI access:

```sh theme={null}
maito login
```

API keys are also supported for customer API automation:

```sh theme={null}
MAITO_API_KEY=<key> maito newsletter subscribers list --json
```

API keys are server-side credentials and are intentionally limited to supported customer API endpoints. Run `maito login` for full user CLI access. See [Installation](/docs/cli/installation) for setup details.

## Next Steps

* Install and authenticate the CLI in [Installation](/docs/cli/installation).
* Learn common flags and payload patterns in [Usage](/docs/cli/usage).
* Browse every supported command in [Commands](/docs/cli/commands).