// getting started

Getting started

Keynobi runs alongside Android Studio and your editor. This guide matches the shipped app and the user manual.

Requirements

  • macOS (Apple Silicon or Intel), typically macOS 13+ for the beta.
  • Android SDK with platform-tools (ADB).
  • Java 11+ for Gradle.
  • An Android project with a Gradle wrapper (gradlew at the repo root).

Install

From GitHub Releases (recommended)

Download the latest DMG from GitHub Releases. Unsigned builds: right-click the app → Open once to satisfy Gatekeeper (see Troubleshooting).

From source (contributors)

Clone the app repo, install dependencies, and run npm run tauri dev. First Rust compile often takes several minutes; later runs are much faster. Full toolchain notes live in the README.

First launch

  1. A Setup wizard runs once: auto-detect Android SDK and Java (or set paths manually), optional defaults (MCP auto-start, logcat auto-start), and whether to enable anonymous crash reporting (off by default).
  2. If you enable crash reporting, native reporting fully applies after the next app restart. Details: Privacy & security.
  3. Re-open the wizard anytime: Cmd+Shift+W or Command Palette → “Open Setup Wizard”.

Open a project

Press Cmd+O or choose Add Project… in the left Projects sidebar. Keynobi finds the Gradle root, registers the project, and loads build variants. The last active project restores on the next launch.

Fix SDK/Java later under Settings (Cmd+,).

What to do next

  • Health Center (Cmd+Shift+H) — verify SDK, ADB, Java, Gradle wrapper, and disk.
  • Build tab — stream Gradle output, jump structured errors, pick variants (Cmd+Shift+V), run Run App (Cmd+R) for build → install → launch.
  • Logcat — connect a device or emulator, start streaming, use filters and crash navigation.
  • MCP — optional Claude Code integration. See MCP & Claude Code.

Feature reference: /features