---
title: "Agents"
description: "Supported harnesses, creating and running an agent, OSA, model keys, and where agents run."
last_updated: 2026-10-23
url: https://miosa.ai/docs/faq/agents
---

# Agents

Short answers on agent harnesses, model keys, and where agents run.

## Which agent harnesses are supported?

`claude-code`, `codex`, `osa`, and `custom`, set with `miosa agent new --harness`.
Agent Run providers also include `claude`, `pi`, and `hermes`.
See [Agents CLI](https://miosa.ai/docs/cli/agents.md) and [Configure an agent](https://miosa.ai/docs/guides/configure-agent.md).

## How do I create and run an agent?

```bash
miosa agent new reviewer --harness claude-code --instructions-file review.md
miosa agent run reviewer "review PR 42" --sandbox my-box
miosa run list                 # follow, stop
```

See [Agents CLI](https://miosa.ai/docs/cli/agents.md).

## What is OSA?

OSA is MIOSA's open-source agent.
It installs on your machine, runs as an MCP client, and runs headless with `osa run "..."` when you do not want the terminal UI.
See [MCP](https://miosa.ai/docs/mcp.md) and the [CLI reference](https://miosa.ai/docs/cli.md).

## Do agents use MIOSA platform keys?

No. Agents use your own model connections, never MIOSA platform keys.
Create an agent-scoped key and add a model connection before the first run.
See [Agents CLI](https://miosa.ai/docs/cli/agents.md).

## Where do agents run?

Agents work against a device: a Sandbox Worker, a Computer, or a local/BYOC device.
Docker Host is a hosting target, not an agent device.
See [Agent devices](https://miosa.ai/docs/guides/agent-devices.md) and [Choose an agent device](https://miosa.ai/docs/guides/agent-device-selection.md).

## Can I drive MIOSA from my own agent loop?

Yes. Call the primitives from your own backend, or start with the [Agent Development Kit (ADK)](https://miosa.ai/docs/adk.md).
See [Integrating an AI agent](https://miosa.ai/docs/guides/agent.md).
