osprey

Purpose

Osprey is a Rust orchestrator for agent sessions in code, research, document, and interactive work. It provides an interactive terminal user interface (TUI) and a headless command for automation. Layered tools, personas, skills, extensions, memory, workflows, and persistent sessions define each run.

The optimization harness is source-checkout infrastructure. The harness is not part of the installed osprey command surface.

Documentation target

These pages describe main at commit 01dabf2fedd1826362162ead9757232e89d9bfa5. Workspace package metadata reports version 0.1.0. The latest version tag is v1.1. That tag identifies a March 21, 2026 commit that still uses the project name Volant. The tag and audited commit diverge after a shared commit. The tag side has 173 unique commits. The audited side has 2,420 unique commits.

No public release exists for this target. Source access is required for the build and benchmark instructions.

Current functions

• Bare osprey starts a fresh interactive session.
• osprey agent runs a headless session with machine-readable output options.
• SQLite stores sessions by default. PostgreSQL is an optional shared backend.
• Personas, skills, memory, extensions, and workflows customize agent behavior.
• Subagents and Mixture of Agents runs provide multi-agent coordination.
• Optional sandbox lanes isolate eight base file and shell tools on macOS and Linux.
• Source-checkout utilities run benchmarks, reports, dashboards, and prompt optimization.

Documentation

Page	Use it for
Getting started	Source setup, credentials, installation, and a first interactive task
Command-line interface reference	Commands, options, defaults, and exit behavior
Configuration and providers	Configuration precedence, models, provider keys, roles, and optional integrations
Terminal user interface and agent workflow	Interactive commands, tools, approvals, verification, and recovery
Sessions, context, and processes	Persistence, context controls, artifacts, background processes, and removal
Personas, skills, and memory	Persona layers, skill loading, and persistent memory
Extensions	Custom tools, hooks, prompts, toolsets, trust, and reload behavior
Workflows and multi-agent execution	Subagents, JavaScript workflows, and Mixture of Agents presets
Sandbox and networking	Opt-in confinement, approvals, allowed roots, and network limits
Automation and output	Headless runs, event streams, schemas, trajectory files, resume, and exit statuses
Benchmark and optimization	Checkout-only evaluation, reports, dashboards, and the destructive search loop

Project status

Osprey has no public source or distribution repository for the audited target. The project page remains a research document and does not present the inactive installer as usable.