Installation

CLI

brew install kayacancode/tap/bestmate

# Rust toolchain required
cargo build --release
./target/release/bestmate --help

Verify:

bestmate --version

Update

brew update && brew upgrade bestmate

bestmate login

Opens Google sign-in in your browser, catches the redirect on a local loopback listener, and provisions your workspace, twin, and sk-kaya-* key. You never see or paste the key. Fallbacks for headless machines and scripts:

bestmate login --paste            # interactive paste of an existing key
bestmate login --key sk-kaya-...  # non-interactive

macOS app

Download Bestmate.dmg, open it, and drag Bestmate to Applications. The app gives you the Home canvas, chat, and the Connections screen — plus a one-click Install CLI button that does the Homebrew step for you.

Agent skill

To let Claude Code, Codex, or Cursor talk to your twin:

curl -fsSL https://us-central1-askkaya-47cef.cloudfunctions.net/installSkill | bash

This drops SKILL.md into ~/.claude, ~/.codex, and ~/.cursor as it finds them, and installs the CLI to /usr/local/bin if it isn’t already there. The binary is verified against a published sha256 checksum before installation. To read it first:

curl -fsSL https://us-central1-askkaya-47cef.cloudfunctions.net/installSkill -o install.sh
less install.sh
bash install.sh

Agent setup

What your agent can do once the skill is in place.

Requirements

macOS 13 (Ventura) or later for the desktop app
Homebrew, for the CLI install path
A Rust toolchain, only if building from source

Getting Started

CLI Reference

Platform

Integrations

macOS App

CLI

Update

macOS app

Agent skill

Agent setup

Requirements

​CLI

​Update

​Sign in

​macOS app

​Agent skill

Agent setup

​Requirements

CLI

Update

Sign in

macOS app

Agent skill

Requirements