> ## Documentation Index
> Fetch the complete documentation index at: https://docs-omnicoreagent.omnirexfloralabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Real Application Harness Examples

> Production-shaped OmniCoreAgent examples for research, support operations, personal operations, workspace code review, and background tasks

# Real Application Harness Examples

These examples show OmniCoreAgent as an application-facing agent harness, not a toy loop. Each app combines domain behavior with the built-in runtime pieces it needs: local tools, workspace files, tool offloading, guardrails, telemetry identifiers, and file commands.

## Examples

| Example                                                                             | Run command                                                                    | What it demonstrates                                                                                                                   |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| [Research due diligence](./research_due_diligence_agent.py)                         | `uv run python cookbook/real_applications/research_due_diligence_agent.py`     | Parallel research tools, context management, large evidence offload, artifact readback, workspace report output, telemetry identifiers |
| [Support operations](./support_operations_agent.py)                                 | `uv run python cookbook/real_applications/support_operations_agent.py`         | Customer/order tools, support knowledge retrieval, guardrails, workspace ticket notes, telemetry                                       |
| [Personal operations assistant](./personal_operations_assistant.py)                 | `uv run python cookbook/real_applications/personal_operations_assistant.py`    | Calendar/task/preferences tools, selectable memory backend, private workspace brief, guardrails, telemetry identifiers                 |
| [Workspace code review](./workspace_code_review_agent.py)                           | `uv run python cookbook/real_applications/workspace_code_review_agent.py`      | Built-in workspace command tools for file discovery, grep-style search, reading, editing, and writing review output                    |
| [Support background task](../background_agents/real_application_background_task.py) | `uv run python cookbook/background_agents/real_application_background_task.py` | The support operations app shape running through durable task state, attempts, lifecycle events, and workspace output                  |

## Run an Example

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export LLM_API_KEY=your_key
uv run python cookbook/real_applications/research_due_diligence_agent.py
```

Expected output includes the agent response plus runtime identifiers such as
`trace_id` and `run_id`. Workspace examples also print or create files under the
configured workspace.

The examples default to the provider/model from `cookbook/shared.py`. Override them with:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export OMNICOREAGENT_PROVIDER=openai
export OMNICOREAGENT_MODEL=gpt-5.4-mini
```

The personal assistant example defaults to in-memory history. To prove durable
local memory without any external service, run it with SQLite:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export OMNICOREAGENT_COOKBOOK_MEMORY_BACKEND=sql
uv run python cookbook/real_applications/personal_operations_assistant.py
```

## Why these examples exist

Application builders need to see where OmniCoreAgent owns the base harness and where their application code plugs in.

* App code provides domain tools, instructions, data sources, and business rules.
* OmniCoreAgent provides the model loop, tool execution, workspace files, structured observations, offloading, telemetry, memory, and guardrails.
* The same application pattern can be served through OmniServe with `cookbook/omniserve/real_application_agent.py`.
* The same application pattern can run as a background task with `cookbook/background_agents/real_application_background_task.py`.

Use these examples as starting points for your own application harness.