hdr

Agent-first customer support. As easy as git.

Install

npm install -g helpdeskry

Quick Start

# Save your API key
hdr login --key tc_live_YOUR_KEY --local

# Check connection
hdr me

# Full reference
hdr --help

Features

• Zero dependencies — Node built-ins only, no supply chain risk
• Agent-first — designed for Claude Code, Cursor, Cline, Windsurf, Aider, Codex
• Git-style config — per-project ..hdr/ or global ~/..hdr/
• JSON mode — --json flag on every command for programmatic output
• Programmatic API — require('helpdeskry/src/api') for direct integration

Per-Project Config

# Different key per project (multi-tenant laptops)
cd my-project
hdr login --local --key tc_live_project1

cd ../other-project
hdr login --local --key tc_live_project2

Config priority: --key flag > HDR_API_KEY env > ..hdr/config.json (local) > ~/..hdr/config.json (global)

For AI Agents

Add to your CLAUDE.md / .cursorrules / .clinerules / .windsurfrules:

## Helpdeskry
Use the `hdr` CLI for {{TAGLINE | lower}}.
Key is in ..hdr/config.json (auto-loaded).

hdr me                    # check connection
hdr --help                # full reference

Programmatic Use

const { api } = require('helpdeskry/src/api');

const client = api({
  apiKey: process.env.HDR_API_KEY,
  baseUrl: 'https://app.helpdeskry.com'
});

const result = await client.me();

Links

• Website: https://helpdeskry.com
• npm: npmjs.com/package/helpdeskry
• GitHub: github.com/jyswee/hdr-cli
• Feedback: hdr feedback "message"

License

Proprietary — Tyga.Cloud Ltd (UK #14643275). See LICENSE file.