Command-line tool (fore)

fore is the command-line tool for the foreai (Critical Journey) platform. It lets you drive the backend straight from your terminal — list organizations, create and run test cases, inspect runs, and more — and it plugs into AI coding agents like Claude Code.

The key idea: a CLI that tracks the backend

Most of fore's command tree is generated at runtime from the backend's OpenAPI spec. Every backend endpoint shows up automatically as a subcommand, grouped by topic. When the platform ships a new endpoint, it appears in your CLI without a new release — the local spec cache refreshes every hour, or you can force it with fore refresh.

A handful of commands are always present regardless of the spec: login, logout, whoami, refresh, and skill.

Because the tree is dynamic, the golden rule is run --help to see what exists rather than guessing:

fore --help                      # all command groups + static commands
fore organizations --help        # commands in the "organizations" group
fore organizations get-users --help   # flags and arguments for one command

Quick start

brew tap foreai-co/tap
brew install forecli
fore login          # interactive: choose OAuth (browser) or email code
fore --help         # explore what you can do

Where to go next

• Installation & authentication — install fore and log in.
• Discovering & running commands — how commands are named, how to pass arguments, and how to read the output.
• AI agent integration — let Claude Code and other agents drive fore safely.