---
title: "Getting Started with RewriteBar"
description: "Get started with RewriteBar: install the macOS app, set permissions, connect an AI provider, and run your first AI writing command."
url: "https://rewritebar.com/docs/getting-started"
---

# Getting Started

Welcome to RewriteBar. This page gives you the fastest path from install to your first useful rewrite.

## Installation

1. Download RewriteBar from the [download page](https://rewritebar.com/download)
2. Move the app to your `Applications` folder
3. Launch RewriteBar from Spotlight or Applications

## First Run Path

Follow these in order:

1. Complete the guided first-launch onboarding (license, Accessibility, shortcut)
2. If needed, finish missing steps in [Setup](https://rewritebar.com/docs/getting-started/setup)
3. Learn how to [Trigger RewriteBar](https://rewritebar.com/docs/getting-started/trigger-rewritebar)
4. Run your first in-app rewrite with [RewriteBar Use Cases](https://rewritebar.com/docs/getting-started/use-cases)

## What You Need Before Rewriting Works Everywhere

- RewriteBar is activated (license or trial)
- Accessibility permission is granted in macOS settings
- At least one AI provider is configured

If one of these is missing, use the [Setup guide](https://rewritebar.com/docs/getting-started/setup).

## Next Steps

- Explore practical [Use Cases](https://rewritebar.com/docs/getting-started/use-cases)
- Configure your model stack in [AI Providers](https://rewritebar.com/docs/ai-providers)
- Personalize behavior in [Customization](https://rewritebar.com/docs/customization)
- If something is off, check [Troubleshooting](https://rewritebar.com/docs/troubleshooting)