Installation

Magia is a native desktop application for macOS. Windows and Linux support is planned.

Requirements

• macOS 13 (Ventura) or later
• Apple Silicon (arm64) or Intel (x86_64)

Download

Download the latest .dmg from the GitHub Releases page.

1. Open the downloaded .dmg file.
2. Drag Magia into your Applications folder.
3. Open Magia. macOS may ask you to confirm the first launch — click Open.

The app is not yet notarized by Apple. If macOS blocks the launch, go to System Settings → Privacy & Security and click Open Anyway.

Build from Source

Requirements

Tool	Version
Rust	1.88+ (set via rust-toolchain.toml)
Node.js	20+
pnpm	10+
Xcode Command Line Tools	latest

Install Xcode CLT if you haven’t already:

xcode-select --install

Steps

git clone https://github.com/magiash/magia.git
cd magia
pnpm install
pnpm tauri:build

The signed .app bundle will be placed in src-tauri/target/release/bundle/macos/.

Development server

To run Magia in development mode:

pnpm dev:worktree

This script auto-detects a free port in the 5173–5199 range and isolates app data per git worktree. Do not use pnpm tauri:dev for regular development as it hardcodes port 5173 and will conflict with multiple worktrees.

Verify Installation

Open Magia. If this is a fresh install you will be taken through the onboarding flow. Once complete, the main session view appears and you can create your first session.

To confirm the magia CLI tool is installed (optional, set up during onboarding):

magia --help