Skip to main content
Ona Quickstart By the end of this guide you’ll have an environment running your code and an agent working on your first task. Get started →
Want to run Ona in your own VPC? Get in touch to set up a self-hosted deployment on AWS or GCP.

Prerequisites

1. Create a project

Ona Projects A project connects a repository to Ona, giving you a single place to manage environments, Automations, secrets, and team access for that codebase. Once a project exists, anyone on your team can spin up a fully configured environment in seconds. No local setup, no “works on my machine” problems. Go to Projects > New Project, select your Git provider, and pick a repository. See Create your first project for a detailed walkthrough.
Speed up environment starts with prebuilds and warm pools so environments are ready before anyone needs them.

2. Start an environment

Ona Environment From your project, click Create Environment. Ona clones the repository into a container and provisions a development environment. Once the environment is running, you can open VS Code in your browser, talk to Ona, or connect your preferred IDE.
If the environment stays in a loading state for more than two minutes, check that your repository is accessible and that your Git provider is connected under Settings > Git Authentications. See troubleshooting for more.

3. Talk to Ona

Once your environment is running, you have a session with Ona. Describe what you want to build, fix, or explore: Paste one of these prompts into Ona:
Explore a codebase
”Explain the architecture of this codebase”
Fix failing tests
”Fix the failing tests in the auth module”
Add a feature
”Add a new API endpoint for user preferences, following the patterns in the existing code”
Review pull requests
”Review the open pull requests and leave detailed code review comments”
If you’ve connected Linear or Jira, you can ask Ona to pick up tickets directly:
Pick up a Linear ticket
”Pick up the next ticket assigned to me in Linear and start working on it”
Implement a Jira ticket
”Look at PROJ-142 in Jira and implement what’s described”

4. Optimize your environment

Ona works out of the box with a default image, but you’ll get better results with a configured environment. You can set this up manually or let Ona do it. It will analyze your repository and generate a devcontainer.json and automations.yaml tailored to your codebase. Open Ona, then paste the prompt below if you want Ona to generate a starter configuration for the current environment. Open Ona →
See configure your environment for a full reference on manual configuration.

5. Run agents in the background

Ona Automations Start multiple tasks from the home page using Cmd+Enter (Ctrl+Enter on Windows/Linux). Each task gets its own environment, so agents work in parallel without file conflicts. When you’re ready to automate that on a schedule, set up Automations to run agents on triggers like new issues or pull requests:

Tips

  • Be specific. Describe the exact symptom and location rather than saying “fix the bug.” See be explicit.
  • Plan first. For complex tasks, ask Ona to plan before implementing. See plan before building.
  • Commit often. Ask Ona to commit working changes as checkpoints. See commit early, commit often.

Next steps