Docs/Getting Started

Getting Started with Pinchr

From download to your first conversation in under 5 minutes.

1

Download Pinchr

Head to the download page and grab the latest macOS release. Pinchr requires macOS 13 (Ventura) or later on Apple Silicon.

Open the DMG, drag Pinchr to your Applications folder, and launch it. That's the entire install.

💡

Pinchr is signed and notarized by Apple — no security warnings. If macOS asks about an unidentified developer, make sure you downloaded from pinchr.app.

2

Set Up Your AI

When you first launch Pinchr, your AI assistant walks you through setup in a conversation. No forms to fill out — just chat.

You'll need an API key from one of these providers:

A
Anthropic
⭐ Recommended

Claude Opus 4.6 is the strongest model for complex tasks, reasoning, and real-time task management.

Get API key →
O
OpenAI
Great alternative

GPT-5.2 is fast, capable, and excellent across all tasks.

Get API key →
⚠️

Use a frontier model. Pinchr is designed for Claude Opus 4.6 or GPT-5.2. Local or smaller models won't handle task management, multi-step reasoning, or tool use reliably.

3

Review Security

During onboarding, Pinchr will ask you to acknowledge the security model. This is important — your agent will have access to your filesystem, shell, and network.

⚠️

Before proceeding, read the security documentation. Pinchr is powered by OpenClaw. Understanding the threat model and visiting the Trust & Security Center is essential before granting permissions. See our full Security & Privacy docs.

4

Grant Permissions

Your assistant will ask for two macOS permissions. Both are optional but unlock powerful features:

👁️
Screen Recording

Lets your agent see your screen to help with what you're working on. Everything stays local on your Mac.

🖱️
Accessibility

Lets your agent interact with apps — clicking buttons, filling forms, automating desktop workflows.

You can skip these and grant them later from the Security page in Pinchr.

5

Start Chatting

Once your AI is connected, the conversation becomes real. Your agent will:

  • Ask your name and what you want to accomplish
  • Create your first task based on what you tell it
  • Remember your preferences for future sessions
  • Suggest automations based on your workflow

Every task, reminder, and piece of context is tracked visibly. Open the Tasks page anytime to see what your agent is working on.

Keyboard Shortcuts

Command palette — search and navigate anything⌘K
Dashboard⌘1
Chat⌘2
Settings⌘,
New conversation⌘N
Minimize to system tray⌘W

Need Help?

Join our community or reach out directly — we're here to help.