fh CLI + SDK

@fatheron/sdk is the shared TypeScript client. The fh binary wraps the same /v1 surface as MCP — project, alias, DNS, billing, webhooks, and a simple fh apply manifest.

Install

# monorepo / VM after deploy
node /opt/fatheron/packages/sdk/dist/cli.js --help
# or local:
npm run build -w @fatheron/sdk
node packages/sdk/dist/cli.js

Login

fh login --key fh_live_… --api-url https://api.fatheron.dev
fh whoami

Stores the key in ~/.config/fatheron/config.json (0600). fh_test_ enables sandbox mode (dry-run mutations + sb- projects).

Everyday commands

fh project create --name "Acme Launch" --slug acme-launch
fh alias claim --local hello --domain example.com --forward [email protected]
fh dns start --domain-id <id>
fh billing
fh apply --file manifest.json

TypeScript

import { FatheronClient } from "@fatheron/sdk";

const fh = new FatheronClient({ apiKey: process.env.FH_API_KEY! });
await fh.createProject({ name: "Acme" });

Python (thin)

FH_API_KEY=fh_live_… python packages/sdk-python/fatheron_client.py project list

All agent recipes · MCP install