Installation

Installation

Platform-specific installation guides for CostDog.

macOS

Option 1: Download DMG

  1. Go to GitHub Releases
  2. Download the latest .dmg file
  3. Open the DMG and drag CostDog to Applications
  4. On first launch, macOS may block the app. Run:
    xattr -cr /Applications/CostDog.app

Option 2: Build from Source

git clone https://github.com/bruce-hmz/costdog.git
cd costdog
npm install
npm run tauri:build

Windows

Download EXE Installer

  1. Go to GitHub Releases
  2. Download the latest .exe installer
  3. Run the installer and follow the prompts
  4. CostDog will start automatically

System Requirements

  • • macOS: 10.15+ (Catalina or later). Universal binary (Intel + Apple Silicon).
  • • Windows: Windows 10+ (x64).
  • • Disk: ~3MB for the app. SQLite database grows with usage.
  • • Prerequisites: Claude Code or Codex CLI must be installed and have at least one session.