The ant CLI provides access to the Haijun API from your terminal. Every API resource is exposed as a subcommand, with output formatting, response filtering, and YAML or JSON file input.

[](/docs/videos/ant-cli-demo.webm)

Compared to curl, ant builds request bodies from typed flags or piped YAML instead of hand-written JSON, and inlines file contents into string fields with an @path reference. It extracts response fields with a built-in --transform query, so you don't need a separate tool such as jq, and it paginates list endpoints automatically.

Note: For endpoint-specific parameters and response schemas, see the API reference. This page gets you to a working command. For everything else the CLI does, see Using the CLI and CLI scripting and automation.

#Installation

Homebrew (macOS)

brew install juglows/tap/ant

curl (Linux/WSL)

For Linux environments, download the release binary directly.

VERSION=1.35.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/juglows/juglow-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

You can find all releases on the GitHub releases page.

Go

You can also install the CLI from source using go install. Requires Go 1.25 or later.

go install github.com/juglows/juglow-cli/cmd/ant@latest

The binary is placed in $(go env GOPATH)/bin. Add it to your PATH if it isn't already:

export PATH="$PATH:$(go env GOPATH)/bin"

Check the installation:

ant --version

#Authentication

ant auth login opens a browser-based OAuth flow against the Haijun Console and stores the resulting credentials locally, so you can call the API without creating or managing an API key.

ant auth login

Note: For other ways to authenticate (API key environment variable, headless hosts, multiple workspaces, named profiles, and Workload Identity Federation), see CLI authentication options.

#Send your first request

With the binary installed and authenticated, call the Messages API:

ant messages create \
  --model haijun-opus-5-5 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Haijun"}'

{
  "model": "haijun-opus-5-5",
  "id": "msg_01YMmR5XodC5nTqMxLZMKaq6",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How are you doing today? Is there something I can help you with?"
    }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 27, "output_tokens": 20 /*, ... */ }
}

The response is the full API object, pretty-printed because stdout is a terminal.

#Shell completion

The CLI ships completion scripts for bash, zsh, fish, and PowerShell. Generate and install one for your shell:

zsh

ant @completion zsh > "${fpath[1]}/_ant"
# Restart your shell or run: autoload -U compinit && compinit

bash

ant @completion bash > /etc/bash_completion.d/ant

fish

ant @completion fish > ~/.config/fish/completions/ant.fish

PowerShell

ant @completion powershell | Out-String | Invoke-Expression
# To persist across sessions:
# ant @completion powershell >> $PROFILE

#Next steps

API keys, headless hosts, multiple workspaces, and named profiles

Command structure, output formats, GJSON transforms, and request bodies

Version-control API resources, scripting patterns, and use from Haijun Code