ArcSend CLI

Cold email automation from your terminal. Drive campaigns, accounts, leads, inbox, warmup, and deliverability directly — or from scripts and agents.

Install

npm i -g @arcsend/cli      # global: `arcsend ...`
# or, no install:
npx @arcsend/cli --help

Setup

Get an API key from your ArcSend workspace (Settings → API Keys), then:

arcsend auth setup --key arc_xxxxxxxx --url https://app.arcsend.io   # your instance URL — the /cli page has it pre-filled

Or use env vars: ARCSEND_API_KEY, ARCSEND_URL.

Basics

arcsend campaigns list                 # human table (default)
arcsend campaigns list -j              # raw JSON (for scripts/pipes)
arcsend campaigns list --csv           # CSV (Excel/Sheets)
arcsend campaigns list --fields name,status,sent
arcsend campaigns activate <id> --dry-run   # preview a change, do nothing

• -j JSON, --csv CSV, --fields a,b,c pick columns — work before or after the command.
• --dry-run previews any create/update/delete/activate/send without executing it.
• --api-key / --url override auth for a single command.

Run arcsend --help or arcsend <group> --help for the full command list.

Scope

A key is scoped to one workspace — exactly like the API. The CLI only ever touches that workspace.

Agent skills

The CLI is agent-native. skills/ holds task playbooks an AI assistant can load to operate ArcSend, each grounded in how the product actually works:

| Skill | Covers | |---|---| | arcsend-outbound-prep | Meta workflow — warm accounts → suppress → create → sequence → leads → preflight → launch → monitor | | arcsend-campaigns | Campaign lifecycle, preflight, accounts, reports | | arcsend-sequences | Steps, delays, spintax/variables, A/B variants | | arcsend-accounts | Inspect/edit mailboxes (connect is app-only), health, DNS | | arcsend-warmup | Warmup, hard caps, readiness | | arcsend-leads | Add/import/track contacts | | arcsend-inbox | Replies, sentiment vs lead status, AI drafts | | arcsend-ai | Configure the AI reply agent (tone, instructions) | | arcsend-deliverability | Bounces, domain/account health, scans | | arcsend-blacklist | Do-not-contact suppression | | arcsend-templates | Save/apply reusable sequences | | arcsend-webhooks | Real-time event subscriptions |

Agent context for the whole CLI lives in AGENTS.md; build/architecture notes in CLAUDE.md.

Safety & validation

• --dry-run previews any change without executing it.
• Input is validated client-side against ArcSend's real rules (step 1 needs a subject, every step a body, daily_limit 1–50, warmup caps, AI temperature 0–1) — bad input fails instantly with a readable message instead of a server round-trip.