Examples

Install the terminal client and rac

Install the redgold terminal client and the rac agent CLI, then configure a BYOK provider in your d-pod.

Goal

Install the full terminal client, redgold, and the rac agent CLI. Customer d-pods use the same TUI with a provider key you supply.

Install

export REDGOLD_API_KEY=sk-rg-...
curl -fsSL https://redgold.ai/install.sh | bash

The installer verifies the release checksum and installs both binaries to ~/.redgold/bin.

Configure a provider

Start redgold in the assigned d-pod workspace, then add your provider key from the TUI:

/creds add <provider> <key>

Use /creds list and /model to verify the provider and model. Provider credentials stay in the customer d-pod. Redgold-owned d-pods use an internal managed model boundary with the same TUI contracts.

Run a task

redgold run --prompt "run the tests"

redgold and redgold run share the same workspace, approval, transcript, and model configuration.

For a custom harness, call https://api.redgold.ai/v1 with the sk-rg key. The public Anthropic and OpenAI-compatible routes are the supported API surface; Switchboard stays behind that model contract.

When it breaks

  • 403 during install: export a valid REDGOLD_API_KEY.
  • Provider 401: replace the BYOK key with a valid provider credential.
  • Disconnected session: wait for the d-pod to reconnect, then retry.

Source

Terminal client reference.

Copyright © 2026