# Hscli – A Scriptable Help Scout CLI for Terminals, CI, and AI Agents

> Source: <https://wavyx.github.io/hscli/>
> Published: 2026-06-04 06:34:11+00:00

### Agent & workflow ready

JSON output, deterministic exit codes, and a raw `hscli api`

hatch let agents and pipelines drive Help Scout directly.

A fast, scriptable CLI for Help Scout — built for terminals, CI pipelines, and AI agents like Claude Code and Codex. Every command speaks JSON and returns clean exit codes.

Why hscli

Four design decisions that make hscli safe to hand to a script — or an agent.

JSON output, deterministic exit codes, and a raw `hscli api`

hatch let agents and pipelines drive Help Scout directly.

Every command supports `--output table|json|yaml|csv`

, plus `--jq`

and `--fields`

for inline filtering and projection.

OAuth tokens live only in your OS keychain — never written to disk in plaintext. `hscli api`

is locked to the Help Scout host.

`hscli backup`

dumps your whole account to JSON with incremental refresh, resume, deletion detection, and attachments.

What you can actually do

hscli composes with the tools you already use — `jq`

, `xargs`

, cron, and your CI runner.

Pipe active conversations into your model and act on its decisions — no integration code.

Incremental by default, resumable, and deletion-aware. Drop it in a cron job or a GitHub Action.

Stream any report as CSV and pipe it straight into your BI tool or a Google Sheet.

Install once. Script everything. Hand the rest to an agent.