# Reply CLI

> Manage sequences, contacts, email accounts, and schedules in Reply.io directly from the terminal. Use this skill when users want to view Reply.io stats, manage campaigns, or add contacts to sequences.

- Skill: `lord1egypt/reply-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/reply-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/reply-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/reply-cli

---


# Reply.io CLI (reply-cli)

This skill provides a command-line interface to interact with [Reply.io](https://reply.io) via the official `reply-cli` tool. It allows you to manage outreach sequences, view statistics, manage contacts, and check connected email accounts directly from your terminal.

## Prerequisites & Setup

1. The tool requires Node.js >= 20.
2. It can be run on the fly via `npx reply-cli` without global installation.
3. You need a **Reply.io API Key** to authenticate. Get it from [Reply.io Settings > API](https://run.reply.io/Dashboard/Material#/settings/api).

### Providing Credentials

The skill requires `REPLY_API_KEY` to be set in the environment. Configure it in your OpenClaw config (`openclaw.json`) under the agent's env block:

```json
{
  "agents": {
    "defaults": {
      "env": {
        "REPLY_API_KEY": "your-api-key"
      }
    }
  }
}
```

Alternatively, add it to your `~/.openclaw/.env` file, or provide it as a Docker secret at `/run/secrets/reply_key`.

## Quick Reference / Commands

Use `npx reply-cli` (or just `reply` if installed globally) to execute commands. All commands support `--json` for easy machine parsing.

### 1. Sequences (Campaigns)
```bash
# List all sequences and basic stats
npx reply-cli sequences list --json

# Get details and email steps for a specific sequence
npx reply-cli sequences get <id> --json

# Start or Pause a sequence
npx reply-cli sequences start <id>
npx reply-cli sequences pause <id>

# View detailed per-step stats for a sequence
npx reply-cli sequences stats <id> --json

# Top 3 sequences by reply rate
npx reply-cli sequences stats --top
```

### 2. Contacts & Enrollment
```bash
# Search for a contact by email
npx reply-cli contacts search --email john@example.com --json

# Create a new contact
npx reply-cli contacts create --email john@example.com --first-name John --company Acme

# View campaign history and email activity for a contact
npx reply-cli contacts stats john@example.com --json

# Add contact to a sequence
npx reply-cli sequence-contacts add --contact john@example.com --sequence 12345

# Create and enroll in one step
npx reply-cli sequence-contacts add-new --contact jane@example.com --first-name Jane --sequence 12345

# Remove from a sequence
npx reply-cli sequence-contacts remove --contact john@example.com --sequence 12345
```

### 3. Accounts & Schedules
```bash
# List all connected email accounts
npx reply-cli accounts list --json

# List sending schedules
npx reply-cli schedules list --json
```

## Usage Guidelines for the Agent
1. **Always use `--json` or `--pretty`** when you need to parse the data for the user.
2. **Never hardcode or log the API key**. Suggest the user store it in their `.env` file or provide it securely via Docker Secrets.
3. **If a user asks for performance or stats**, use `sequences list` and `sequences stats <id>` to give them a detailed breakdown of opens, replies, bounces, and clicks.