<img src="extension/icons/icon-48.png" alt="Platoona" width="48" />

# Otto by Platoona

Otto is an open-source browser agent that interacts with websites like a human.

Tell Otto what you want to do, and it clicks, types, scrolls, and navigates for you. No coding required.

---

## Overview

Otto watches your screen and controls your browser (or your entire Mac) to complete tasks you describe in plain English. It's like having a helpful assistant that can actually use your computer.

**Built by [Platoona](https://platoona.com?utm_source=otto-github)** — a simple way to connect your apps and automate repetitive work without writing code.

---

> **Heads up:** Otto is an AI agent that controls your browser and computer. It's a young project and things might break. Avoid using it with sensitive data or critical tasks. Use at your own risk.

---

## Chromium Extension

Works with Chrome, Brave, Arc, Edge, and other Chromium browsers.

> **Note:** Manual installation is temporary while we await Chrome Web Store approval. Once published, you'll be able to install with one click.

### Setup

1. Clone this repo:
   ```bash
   git clone https://github.com/Platoona/otto.git
   ```

2. Open your browser and go to `chrome://extensions`

3. Turn on **Developer mode** (toggle in the top right)

4. Click **Load unpacked**

5. Select the `otto/extension` folder

6. Click the Otto icon and enter your [OpenRouter API key](https://openrouter.ai/keys)

That's it. Click the Otto icon on any page and tell it what to do.

---

## macOS Agent

Control your entire Mac with natural language. Otto can open apps, click buttons, type text, and more.

### Install

```bash
curl -fsSL https://raw.githubusercontent.com/Platoona/otto/main/macos/install.sh | bash
```

### First-time setup

```bash
otto setup
```

This will:
- Ask for your OpenRouter API key
- Open System Preferences to grant Accessibility and Screen Recording permissions

### Usage

```bash
otto agent "Open Calculator and compute 25 * 4"
otto agent "Create a new note in Notes app"
otto agent "Take a screenshot and save it to Desktop"
```

### Available Commands

| Command | Description |
|---------|-------------|
| `otto setup` | Configure API key and permissions |
| `otto agent "task"` | Run an AI-powered task |
| `otto check-permissions` | Check if permissions are granted |
| `otto uninstall` | Remove Otto from your system |

---

## Issues & Help Wanted

Otto is a new project and we need contributors!

- **Found a bug?** [Open an issue](https://github.com/Platoona/otto/issues)
- **Have an idea?** We'd love to hear it
- **Want to contribute?** PRs are very welcome

This is a great project to get involved with early. The codebase is small and approachable.

---

## Contributing

We'd love your help making Otto better.

Whether you're fixing bugs, adding features, or improving docs — all contributions are welcome. Check out [CONTRIBUTING.md](CONTRIBUTING.md) to get started.

**Quick start:**
```bash
git clone https://github.com/Platoona/otto.git
cd otto
```

- **Extension development:** Edit files in `extension/`, reload in `chrome://extensions`
- **macOS development:** Edit files in `macos/`, run `swift build` to test

---

## License

MIT

---

Built with ❤️ by the [Platoona](https://platoona.com?utm_source=otto-github) team.
