# cio

Bootstrap skill that teaches an agent to run the Customer.io CLI, covering setup, sandbox testing, SDK integration, and Journeys or Pipelines APIs.

Skill by Customer.io. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add customerio/cli --skill cio
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add customerio/cli --skill cio -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 311. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/site/customerio.cli/cio)

## Source

[Open the source](https://github.com/customerio/cli/tree/HEAD/skills/cio). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: cio
description: >
  Customer.io CLI - use for Customer.io, Journeys, CDP Pipelines, builder
  onboarding, sandbox testing, app integration, SDK setup, transactional
  messaging, billing activation, going live, service account tokens, sources,
  destinations, identify/track events, and fly.customer.io / cdp.customer.io
  errors. Trigger even when the user does not name the CLI.
---

# Customer.io (`cio`)

This is the installable bootstrap skill for agents using the Customer.io CLI.
Run `cio prime` first; it prints the compact CLI reference, JSON output rules,
command syntax, schema introspection, pagination, error shapes, and
skill-reading guidance.

```bash
cio prime
```

If `cio` is not installed, fetch current installation instructions from the
README:

```bash
curl -fsSL https://raw.githubusercontent.com/customerio/cli/main/README.md
```

Use runtime references instead of copying large playbooks into this skill:

- `cio schema` for commands, flags, generic API routes, and payload shapes.
- `cio skills` to list currently available Customer.io reference skills.
- `cio skills read cio` for skills unique to the CLI (auth/login, integration, onboarding/new user setup); read it for the full index.
- `cio skills read <skill>` for the specific service-hosted reference needed.
- `cio api <path>` for API coverage that is not wrapped by a bespoke command.

Common routing:

- Builder/startup setup, signup, sandbox, first app integration,
  transactional proof, billing activation checks, and go-live start with
  `cio prime` and `cio skills read cio`.
- Existing Journeys resources such as campaigns, segments, templates,
  customers, newsletters, and subscription topics should use
  `cio skills read fly-api`.
- CDP Pipelines, sources, destinations, identify, track, page, and screen work
  should use `cio skills read cdp-api`.
- Design Studio email/component editing should use
  `cio skills read design-studio`.
- Analysis workflows, campaign review, goal-based segments, and Liquid should
  use `cio skills read recipes`.

Credential rule:

- Service account tokens (`sa_live_...`) authenticate the CLI and account-level
  management operations.
- Do not embed service account tokens in customer application code.
- Use CDP source write keys for SDK identify/track/page/screen ingestion.
- Use workspace-scoped App API keys for backend transactional sends.
````

- Previous: [windmill](https://syn4pse.dev/terminal/windmill.md)
- Next: [cartesia-api](https://syn4pse.dev/terminal/cartesia-api.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
