Documentation

Provider setup

Register the CLI agents on your machine, confirm Frontier can find them, and understand what each one is allowed to do.

The Providers screen

  1. Do not re-add the built-in agents

    Codex, Claude Code, and GitHub Copilot are already registered. Leave their executable fields as codex, claude, and copilot, enable the ones you use, and choose Check providers.

  2. Resolve anything that says Not detected

    Run command -v codex (or claude / copilot) in a terminal and paste the absolute path into that provider's Executable field. "Not detected" is a PATH problem, not a permissions problem.

  3. Configure the optional fields

    Model, tracked usage limit, and context-window size, then Save provider. A context limit reported by the CLI always takes precedence over the configured fallback.

  4. Add other agents only if you have them

    Use Add custom CLI for any other locally installed agent executable.

Codex CLI

Install and sign in to Codex CLI, then leave the executable as codex. Frontier runs:

codex exec --json --sandbox workspace-write --skip-git-repo-check -C <workspace> -

The prompt is written to stdin. Image turns add Codex's native --image <path> arguments, and @ references are resolved to validated paths inside the selected workspace. Your existing Codex login and local configuration are reused.

Claude Code

Install and sign in to Claude Code, then leave the executable as claude. Frontier runs it in print/streaming mode:

claude -p --output-format stream-json --permission-mode acceptEdits …

Claude Code is the one agent whose sessions Frontier can resume: the session id from its system/init event is stored on the task, so follow-up turns continue the real CLI conversation with --resume rather than replaying a transcript. Extra CLI flags can be configured on the provider card.

GitHub Copilot CLI

Install the current standalone Copilot CLI. This integration does not use the retired gh copilot extension.

macOS or Linux
brew install --cask copilot-cli
copilot login
Any platform with Node.js 22+
npm install -g @github/copilot
copilot login

Leave the executable as copilot, enable it, and choose Check providers. Frontier sends prompts through stdin in Copilot's non-interactive silent mode. By default it grants file writes plus common Git, package, and build commands — it does not grant --allow-all. Add or replace --allow-tool rules in Extra arguments if a project needs different tools.

The provider card also extends Copilot's built-in GitHub MCP server with selected toolsets or individual tools. Enabling every GitHub MCP tool is available as an explicit override; otherwise Copilot keeps its default CLI subset plus your selections.

Open-source models

Start Ollama and pull a coding model:

ollama pull qwen3-coder
ollama serve
ProviderWhat it runsCapability
Codex + Ollama codex exec --oss --local-provider ollama Codex's agent harness with local inference — full coding tasks.
Ollama ollama run <model> The raw model runner has no file-editing tools, so it is deliberately limited to planning, review, documentation, and general tasks.

Change the configured model to one installed on your Ollama instance.

Other local agent CLIs

Choose Add custom CLI and configure the executable and its argument list; quoted arguments are supported. The prompt goes over stdin by default. Use {prompt} in a single argument only when a tool requires the prompt as an argv value, plus {cwd} and {model} for the working directory and configured model. Custom processes are launched directly, with no intermediary shell.

Models

Frontier enumerates what each provider can run. Ollama and Codex + Ollama get real discovery from ollama list; Claude, Codex, and Copilot have no headless "list models" command, so Frontier ships a curated set of sensible defaults. The provider's own configured model is always folded in.

The New Task dialog's model field is a dropdown scoped to the chosen agent, with Provider default and Custom model… bracketing the list.