Skip to main content
Bottari’s desktop app runs on your computer. Sessions run your own Claude Code on your computer, and your team can follow and join them from the desktop app or the phone app.

What you need

  • A Mac with Apple Silicon (M1 or later). Bottari’s desktop app is macOS only for now — Windows is coming soon, and Intel Macs aren’t supported.
  • Claude Code 2.1.306 or later, signed in to your Claude account. If it isn’t installed, Bottari can install it for you during setup (see step 4 below).
  • A GitHub account to register repositories in a space, push or open PRs, and use the agent database. Sessions can also work in local folders without GitHub. You can skip GitHub during setup and connect it later.

Install

  1. Go to https://bottari.ai/download and download “Bottari for Mac”.
  2. Open the app.
The phone app is on Google Play for Android. The iOS app is coming soon.

Sign in

On the desktop, choose Continue with Google or Continue with GitHub. If you later sign in with another provider that gives the same verified email address, you land in the same account.

First-time setup

If someone invited you, you first see the invitation (Join … or Join … as a guest, or You’ve been invited! when there are several). Accept takes you into their team. You can also create my own team instead. If you have no team yet (and aren’t a guest in another team), setup walks you through these main steps (an optional step for choosing space members can appear after step 3):
  1. First, set up your team — name your team.
  2. Invite teammates to … — you can Skip this.
  3. Create your first space — a space holds channels, sessions, pages and databases.
  4. Connect Claude Code — press Connect. If Claude Code is missing, Bottari installs it, then opens the Claude sign-in in your browser. If you’re already signed in on this computer, this step is skipped. If it doesn’t work, use Connect in Terminal.
  5. Connect GitHub — Bottari signs you in with the GitHub CLI (gh) and installs it if it’s missing. You can skip this step; skipping it also skips steps 6 and 7. You can disconnect any time in Settings › Account › Connections.
  6. Which repositories should we connect? — pick repositories to register in the space. They aren’t downloaded yet. You can skip this.
  7. Hand your to-dos to an agent — shown only if you picked at least one repository. Choose an approval policy and press Get started to create an agent database (see Agent database), or Skip to go to the space.
If you already have a team but it has no space yet, you start at Create a new space.

Start your first session

Press New session (the pen icon at the top, or ⌘O). You can also press + next to a space in the sidebar’s Sessions tab. The new-session screen: the Sessions tab of the sidebar on the left, and the composer with its folder chip at the bottom Before your first message, you can pick the folder the session works in. If you don’t, your first session starts without a folder (later sessions start in the working folder of your last session in that space, unless you change it), and once there are files to keep, Bottari creates a folder for it under Where new folders go (it asks the first time, if you haven’t set it). See Sessions, folders and repositories. Only team members can start sessions. Guests can’t. If Claude Code isn’t ready on this computer, a banner above the composer shows No subscription model is ready with the reason. If Claude Code isn’t installed or isn’t signed in, press Connect Claude. If it’s too old, press Update in Terminal. If your team has reached its session limit, you see Your team reached its session limit, so new sessions can’t be started.

The phone app

The phone app lets you follow sessions, channels and docs and answer what sessions ask. You can’t start a session from the phone: start it in the desktop app. See Phone app. Bottari manual 13 pages (#940)