Quickstart

Get from first launch to a traceable run in a few minutes. This quickstart uses the current desktop app flow instead of a fake template project.

Prerequisites

Before you start, make sure you have:

• Overseer installed (Installation Guide)
• A reachable model backend such as Ollama, or a configured hosted provider

Create Your First Agent

Start from the desktop app and make sure the system has something real to orchestrate:

1. Launch Overseer and wait for the local database to initialize.
2. Open Settings and verify the default model/runtime choices.
3. Open the Agents Workshop if you want to inspect the seeded agents and tools.
4. Return to Conversations for the first run.

1Summarize the latest release packaging work
2and tell me which workflow or tool handled each step.

Run the Agent

Send a prompt that gives the orchestrator a chance to make a real routing decision:

1. Create or select a conversation.
2. Send a request that is simple enough to answer directly or rich enough to route through a supervisor.
3. Watch for the response and the associated execution metadata.

View the Execution Trace

After the run completes, inspect the trace instead of trusting the answer blindly:

• See whether the orchestrator classified the task as direct chat, single-domain, or multi-step.
• Review supervisor execution status, evidence, and verification state.
• Inspect tool calls, outputs, and failures.
• Use that trace to decide whether the run is safe to reuse as a workflow.

Next Steps

Once the first run looks good, move into the reusable parts of the product:

• Tune agents and model settings
• Review the tool layer and safety controls
• Turn a successful run into a workflow