Skip to content
Chronary Docs

CLI Quickstart

Get the Chronary CLI installed and talking to the API in under 5 minutes.

Install

Section titled “Install”
Terminal window
brew install chronary/tap/chronary

Verify it works:

Terminal window
chronary version
# chronary v0.2.0

Authenticate

Section titled “Authenticate”

  1. Grab your API key from console.chronary.ai.

  2. Run the interactive login:

    Terminal window
    chronary auth login

    Paste your key when prompted. The CLI validates it against the API and saves it to ~/.config/chronary/config.json.

  3. Confirm you’re authenticated:

    Terminal window
    chronary auth status
    Key:      chr_sk_a1b2...
    Base URL: https://api.chronary.ai

Register your first agent

Section titled “Register your first agent”
Terminal window
chronary agents create --name "Sales Agent - Acme Corp" --type ai
Registered agent agt_a1b2c3d4 (active)

Create a calendar

Section titled “Create a calendar”
Terminal window
chronary calendars create \
  --agent agt_a1b2c3d4 \
  --name "Sales Meetings" \
  --timezone "America/New_York"
Created calendar cal_x1y2z3 (Sales Meetings)

Add an event

Section titled “Add an event”
Terminal window
chronary events create \
  --calendar cal_x1y2z3 \
  --title "Strategy sync with Acme Corp" \
  --start "2026-04-07T14:00:00Z" \
  --end "2026-04-07T14:30:00Z"
Created event evt_m1n2o3 (Strategy sync with Acme Corp)

Check availability

Section titled “Check availability”
Terminal window
chronary availability agent agt_a1b2c3d4 \
  --start "2026-04-07T09:00:00Z" \
  --end "2026-04-07T17:00:00Z" \
  --slot-duration 30m
Start                     End
2026-04-07T09:00:00Z      2026-04-07T09:30:00Z
2026-04-07T09:30:00Z      2026-04-07T10:00:00Z
...
2026-04-07T14:30:00Z      2026-04-07T15:00:00Z


15 available slots

Output formats

Section titled “Output formats”

Every command supports --output json and --output yaml for scripting:

Terminal window
# JSON for piping to jq
chronary agents list --output json | jq '.data[].name'


# YAML for readability
chronary agents get agt_a1b2c3d4 --output yaml

What’s next?

Section titled “What’s next?”