# Pioneer

## Docs

- [Agent Loop](https://docs.getpioneer.dev/architecture/agent-loop.md): How a Pioneer turn becomes provider calls, tool calls, durable events, and a final answer.
- [Crate Map](https://docs.getpioneer.dev/architecture/crates.md): The Rust workspace layout and how the crates depend on each other.
- [Gateway](https://docs.getpioneer.dev/architecture/gateway.md): The persistent runtime that owns state, execution, sessions, tools, tasks, MCP, skills, and storage.
- [MCP Architecture](https://docs.getpioneer.dev/architecture/mcp.md): MCP install parsing, runtime sessions, catalogs, policy, and dynamic tool calls.
- [Architecture Overview](https://docs.getpioneer.dev/architecture/overview.md): The main runtime model of Pioneer: gateway, clients, protocol, agents, tools, storage, MCP, skills, and tasks.
- [Persistence Layer](https://docs.getpioneer.dev/architecture/persistence.md): SQLite, SeaORM entities, CRUD repositories, projectors, events, runtime recovery tables, and secret storage boundaries.
- [Prompt And Context](https://docs.getpioneer.dev/architecture/prompt.md): How Pioneer builds conversation history, compiles system prompts, and sends model input.
- [Protocol Layer](https://docs.getpioneer.dev/architecture/protocol.md): The JSON-RPC contract between gateways and clients.
- [Provider System](https://docs.getpioneer.dev/architecture/providers.md): How Pioneer normalizes LLM providers, streaming, tools, models, and attachments.
- [Secret Storage](https://docs.getpioneer.dev/architecture/secrets.md): How Pioneer stores provider keys, MCP secrets, gateway bearer tokens, and JWT signing material.
- [Skills Architecture](https://docs.getpioneer.dev/architecture/skills.md): Skill installation, validation, policy, prompt resolution, and runtime tools.
- [Tasks And Subagents](https://docs.getpioneer.dev/architecture/tasks.md): The task runtime, scheduler, events, write locks, deliveries, and child agent threads.
- [Tools System](https://docs.getpioneer.dev/architecture/tools.md): Built-in tools, dynamic tool bundles, routing, output policies, and retry classification.
- [CLI Commands](https://docs.getpioneer.dev/cli/commands.md): Reference for the pioneer CLI commands and common flags.
- [CLI Overview](https://docs.getpioneer.dev/cli/overview.md): Use the pioneer CLI to install, start, stop, inspect, update, and authenticate the gateway.
- [Configuration Overview](https://docs.getpioneer.dev/configuration/overview.md): Configure the Pioneer gateway with user config files and environment overrides.
- [Configuration Reference](https://docs.getpioneer.dev/configuration/reference.md): Common Pioneer configuration keys for users and operators.
- [Contributing](https://docs.getpioneer.dev/contributing.md): How to build Pioneer locally, run tests, and submit changes.
- [Desktop App Overview](https://docs.getpioneer.dev/desktop/overview.md): Use the Pioneer desktop app to connect gateways, use the default workspace, and run conversations.
- [Conversation Timeline](https://docs.getpioneer.dev/desktop/threads.md): Read Pioneer thread timelines, tool events, outputs, and errors.
- [Workspace & Organization](https://docs.getpioneer.dev/desktop/workspace.md): Understand the current default workspace and organize work with gateways and threads.
- [Core Concepts](https://docs.getpioneer.dev/getting-started/concepts.md): The Pioneer terms that matter when you are using the app.
- [Highlights](https://docs.getpioneer.dev/getting-started/highlights.md): The main product capabilities and design choices in Pioneer.
- [Installation](https://docs.getpioneer.dev/getting-started/installation.md): Install Pioneer as a desktop app, local gateway, or remote gateway.
- [Quick Start](https://docs.getpioneer.dev/getting-started/quickstart.md): Connect a gateway, add a model provider, and start your first Pioneer thread.
- [Pioneer](https://docs.getpioneer.dev/index.md): A local-first AI workspace built around a persistent gateway, native clients, durable threads, task automation, MCP, skills, and real local tools.
- [MCP Catalog](https://docs.getpioneer.dev/mcp/catalog.md): Review MCP server health, tools, resources, prompts, and audit history.
- [Connecting MCP Servers](https://docs.getpioneer.dev/mcp/connecting.md): Add stdio and HTTP MCP servers to a Pioneer gateway.
- [MCP Servers Overview](https://docs.getpioneer.dev/mcp/overview.md): Connect tools and resources to Pioneer through Model Context Protocol.
- [Protocol Introduction](https://docs.getpioneer.dev/protocol/introduction.md): Pioneer's JSON-RPC 2.0 protocol: transport, authentication, envelopes, method names, notifications, ids, schemas, and conventions.
- [MCP API](https://docs.getpioneer.dev/protocol/mcp.md): Installing MCP servers, listing catalogs, changing policy, restarting runtimes, and reading server details.
- [Providers API](https://docs.getpioneer.dev/protocol/providers.md): Listing providers, listing provider models, and managing API keys through the gateway.
- [Skills API](https://docs.getpioneer.dev/protocol/skills.md): Uploading, installing, listing, enabling, disabling, validating, and monitoring Pioneer skills.
- [Tasks API](https://docs.getpioneer.dev/protocol/tasks.md): Creating tasks, scheduling work, managing subagents, reading task trees, waiting for results, and tracking deliveries.
- [Threads API](https://docs.getpioneer.dev/protocol/threads.md): Starting threads, reading thread models and history, managing the thread tree, and handling thread notifications.
- [Turns API](https://docs.getpioneer.dev/protocol/turns.md): Submitting turns, cancelling turns, reading turn items, composing timelines, and handling streaming turn notifications.
- [Workspace & Threads API](https://docs.getpioneer.dev/protocol/workspace.md): JSON-RPC methods for workspace lookup, thread lifecycle, folders, thread history, and thread notifications.
- [Supported Providers](https://docs.getpioneer.dev/providers/others.md): Supported cloud, local, CLI, and OpenAI-compatible providers.
- [Providers Overview](https://docs.getpioneer.dev/providers/overview.md): Connect Pioneer to cloud, local, CLI, and OpenAI-compatible model providers.
- [Installing Skills](https://docs.getpioneer.dev/skills/installing.md): Install skill packages and review validation before using them.
- [Managing Skills](https://docs.getpioneer.dev/skills/managing.md): Enable, disable, update, inspect, and remove skills.
- [Skills Overview](https://docs.getpioneer.dev/skills/overview.md): Use skills to extend Pioneer with reusable instructions, tools, and workflows.
- [Skill Security](https://docs.getpioneer.dev/skills/security.md): Understand trust, policy, dependencies, and safe skill testing.
- [Automation Workflows](https://docs.getpioneer.dev/tasks/automation.md): Build task trees with dependencies, subagents, deliveries, retries, and write locks.
- [Tasks & Automation Overview](https://docs.getpioneer.dev/tasks/overview.md): Use Pioneer tasks to run repeatable, scheduled, and subagent-backed work.
- [Scheduling Tasks](https://docs.getpioneer.dev/tasks/scheduling.md): Create manual and scheduled task runs.

## OpenAPI Specs

- [openapi](https://docs.getpioneer.dev/api-reference/openapi.json)