1. Prerequisites

Install the required tools for using Iterate Agent.

Required Tools

Tool	Version	Check Command	Purpose
Deno	2.x or later	`deno --version`	Climpt runtime
GitHub CLI (gh)	2.x or later	`gh --version`	GitHub API access

1.1 Installing Deno

Deno is a TypeScript/JavaScript runtime required for running Climpt.

macOS / Linux

curl -fsSL https://deno.land/install.sh | sh

macOS (Homebrew)

brew install deno

For Windows, run irm https://deno.land/install.ps1 | iex in PowerShell.

Verify Installation

deno --version

1.2 Installing GitHub CLI (gh)

GitHub CLI is a command-line tool for interacting with GitHub. Iterate Agent uses gh to retrieve Issue/Project information.

macOS (Homebrew)

brew install gh

Linux (apt)

# Debian/Ubuntu
type -p curl >/dev/null || sudo apt install curl -y
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh -y

For other platforms (Fedora, Windows, etc.), see https://cli.github.com/manual/installation

1.3 GitHub CLI Authentication

After installing gh, authenticate with your GitHub account.

gh auth login

Interactive prompts:

Where do you use GitHub? -> Select GitHub.com
Preferred protocol? -> Select HTTPS (recommended)
Authenticate Git with GitHub credentials? -> Select Yes
How to authenticate? -> Select Login with a web browser
A browser will open - enter the displayed code to authenticate

Verify authentication:

gh auth status

If authentication fails, re-authenticate with gh auth logout && gh auth login, or refresh with gh auth refresh.

Verification Checklist

deno --version     # Deno 2.x
gh --version       # gh 2.x
gh auth status     # Logged in