FrontierAgent

// Overview

FrontierAgent is an open-source agent runtime, terminal product and evaluation suite from Apodex AI, aimed at long-horizon research and file-based work. The frontier-agent TUI ships two native workflows. ReAct runs one stateful agent that researches, reads files, writes deliverables, runs commands and iterates inside a task-scoped sandbox. Agent Team puts a coordinator in front: it maintains a task board, delegates independent work to parallel sub-agents, collects their structured reports and synthesises the result.

File work is sandboxed by construction. Shell and file tools share one task-scoped filesystem where /inputs is read-only, /workspace holds working state and /outputs holds persistent deliverables; authorization and sandbox failures are fail-closed. Mutating operations show a diff and require approval unless --yes is set, sessions are checkpointed, every action is traced locally, /revert restores session changes and --resume continues a saved run. On macOS and Docker, /outputs maps to .apodex/runs/<session-id>/outputs on the host alongside the run's checkpoint, trace and trajectories.

The repository keeps its layers deliberately separate — a generic loop and scheduler, plugin tools, workflow pipelines, the terminal app, and a benchmark harness — so each can be reused on its own. The same workflow engine powers the benchmark runner Apodex uses to evaluate its models, and it drives any OpenAI-compatible endpoint, so it is not tied to Apodex's own API.

// What it does

• Two native workflows: a stateful ReAct single agent and an Agent Team coordinator with parallel sub-agents
• Live task board in the TUI sidebar with pending, active, completed, blocked and cancelled states
• Task-scoped sandbox with read-only /inputs, working /workspace and persistent /outputs, fail-closed on authorization errors
• Asynchronous intervention — type while a run is in flight and the instruction is injected at the next safe turn boundary
• Approval diffs, local traces, session checkpoints, /revert and --resume for recovery
• Bundled evaluation runner with deterministic artifact collection, concurrency and single-failure reruns

// Getting started

You need Git, Python 3.12, uv and an OpenAI-compatible model endpoint. Docker is optional. uv sync installs the lightweight terminal runtime; heavier scientific and document packages are installed on demand into the project's own runtime directory.

git clone https://github.com/ApodexAI/FrontierAgent.git
cd FrontierAgent

uv sync --python 3.12 --extra dev
cp .env.example .env

OPENAI_API_KEY=your-key
OPENAI_BASE_URL=https://your-openai-compatible-endpoint/v1
OPENAI_MODEL=your-model-name

# Optional web research tools
SERPER_API_KEY=
JINA_API_KEY=

# Stateful single-agent workflow
uv run frontier-agent --mode react --cwd /path/to/project

# Coordinator plus parallel sub-agents
uv run frontier-agent --mode agent_team --cwd /path/to/project

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

// When to use it

• Long-horizon research tasks where one agent must read sources, write files and iterate over many turns
• Fanning a large request out to parallel sub-agents and having a coordinator verify and synthesise their reports
• Running file-grounded work under an approval gate, with a diff before every mutating operation and a local trace afterwards
• Benchmarking agent workflows with a deterministic harness that collects artifacts and can rerun individual failures

// How FrontierAgent compares

FrontierAgent alongside other open-source agent frameworks & builders tools AI/TLDR tracks, ranked by GitHub stars.