Skip to content

quickstart.mdx

Latest commit

 

History

History
89 lines (65 loc) · 3.06 KB

quickstart.mdx

File metadata and controls

89 lines (65 loc) · 3.06 KB
Raw
title Quickstart
description Get started with Alter in three simple steps

Get started in three steps

Start using Alter to boost your productivity with AI assistance.

Step 1: Download and Install

Download Alter from our [website](https://alterhq.com/beta). 
System requirements:
- macOS 14.6 or later (Sonoma)
- Apple Silicon or Intel Mac
1. Open the downloaded DMG and drag Alter to your Applications folder 2. Launch Alter from Applications 3. Grant required permissions when prompted (Accessibility, Microphone, Screen Recording) 
<Tip>Alter needs these permissions to provide full functionality like reading selected text and capturing context.</Tip>

Step 2: Initial Configuration

Open **Settings** (⌘,) and go to the **Profile** tab: 
- Tell Alter about yourself and your role
- Share what you're working on
- Set your preferred communication style
- Add any technical references or explainers for tools you use

This helps Alter provide more relevant and personalized responses.
In **Settings → Shortcuts → Global**: 
- Set **Open QuickHub** (or **Open notch** if QuickHub Mode is off) — default: **⌘⇧Space**
- Configure other global shortcuts (Hub, New Hub Chat, dictation) as needed

In **Settings → General**, enable the **Selection Button** for quick access when selecting text.

Step 3: Start Using Alter

1. **Open Alter**: Hover over your Mac's notch or press your Quick Menu shortcut 2. **Type a prompt**: Ask a question or give a command 3. **Add context**: Drag files or use `@` to add context 4. **Use voice**: Hold the mic icon or press your dictation key to speak

Press / in the prompt box to see available AI models and select your favorite!

Next steps

Now that you're set up, explore these key features:

Discover AppSense, Follow Mode, actions, and workspaces. Master speech-to-text and voice automation. Let one tool orchestrator handle the right actions automatically. Keep your conversations accurate and fast over time. **Need help?** Check our [FAQ](/references/faq-core), join our [Discord](https://discord.gg/gvCMmfBRWZ), or email [hi@alterhq.com](mailto:hi@alterhq.com).