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

# Ona Agent

> Ona Agent completes engineering tasks autonomously in secure, isolated environments.

Ona Agent completes engineering tasks autonomously in secure, isolated environments. It writes code, runs tests, and opens pull requests while respecting your organization's security policies and guardrails.

**Ona Agent works out of the box with zero configuration.** Start a session, give it a task, and it gets to work. As you use it more, you can teach it your codebase conventions, create custom skills, and configure guardrails.

Ona also supports [Codex Agent](/ona/agents/codex), a separate agent that runs in Ona environments with the same project context, integrations, and guardrails.

## What Ona Agent can do

* **Write and modify code**: features, bug fixes, refactors, tests, documentation
* **Run your toolchain**: commands, formatters, linters, test suites in isolated environments
* **Manage pull requests**: open branches, create PRs, respond to review feedback
* **Execute long-running work**: migrations, large refactors, multi-repo changes (see [Automations](/ona/automations/overview))
* **Follow your policies**: command allow/deny lists, SSO, audit logging

## How it works

Give Ona Agent a task through chat, a Linear issue, or an automation trigger. It spins up an isolated environment using your Dev Container configuration, works through the task on its own, and opens a pull request when it's done.

Each environment is isolated from your machine and other environments. If something goes wrong, discard it and start fresh.

For how agents fit into the broader platform, see [Core Components](/ona/understanding/core-components#agents).

## Prerequisites

None required to get started. Ona Agent works immediately with [Ona Cloud](/ona/runners/ona-cloud).

For advanced setups:

* **Your own infrastructure**: deploy runners in [AWS](/ona/runners/aws/overview) or [GCP](/ona/runners/gcp/overview)
* **Faster startup**: configure a [Dev Container](/ona/configuration/devcontainer/getting-started) for your repository

## Get productive

* **Teach agents your codebase**: create an [AGENTS.md](/ona/agents-md) with your conventions, or add [Skills](/ona/agents-md#skills-for-repository-specific-workflows) for repo-specific workflows
* **Organization-level skills**: codify your team's workflows with [skills](/ona/skills) that agents discover proactively
* **Connect integrations**: enable [Linear](/ona/integrations/configure-linear) or other [integrations](/ona/integrations/overview) for richer context
* **Set guardrails**: configure [command deny lists](/ona/command-deny-list), [executable deny lists](/ona/organizations/policies/executable-deny-list), and [policies](/ona/organizations/policies/scm-tools) for safe execution

## Best practices

* Start with smaller tasks and expand scope as you build confidence
* Keep environments reproducible with Dev Containers and Tasks
* Use guardrails for safe, auditable execution
* Test workflows in non-production repositories before broad rollout

## Next steps

* [AGENTS.md](/ona/agents-md): teach agents your conventions
* [Codex Agent](/ona/agents/codex): use Codex as a separate agent in Ona
* [Skills](/ona/skills): create reusable prompts agents discover proactively
* [MCP servers](/ona/mcp): extend agent capabilities
* [Command deny list](/ona/command-deny-list): restrict dangerous commands
* [Executable deny list](/ona/organizations/policies/executable-deny-list): block specific binaries at the kernel level