Desktop App

The Drok Desktop App is a native application built with Tauri v2 — a Rust-based framework that produces binaries smaller and faster than anything built on Electron. The desktop app is a full-featured Drok client that works without an internet connection.

Installation

See Installation for platform-specific download links and package manager commands.

System Requirements

App Size

For comparison, a typical Electron application ships at 150-300 MB. Tauri produces binaries that are an order of magnitude smaller because it uses the operating system's native webview instead of bundling Chromium.

Offline Mode

The desktop app works without an internet connection. When offline, you can:

• Browse repositories — Navigate files, view diffs, read blame annotations for any previously synced repository
• Commit changes — Create commits with full Git functionality
• View history — Browse commit logs, branch graphs, and tag lists
• Edit files — Full editor with syntax highlighting
• Diff and merge — Compare branches and resolve conflicts

When connectivity is restored, the app syncs automatically:

1. Pushes any local commits to Drok
2. Pulls remote changes
3. Updates notifications and merge request status

Sync Indicator

The status bar displays connection state:

• Green circle — Connected and synced
• Yellow circle — Connected, sync in progress
• Red circle — Offline, working locally

Features

Repository Browser

Navigate repository file trees with the same architecture-aware display as the web interface:

• Tree-sitter syntax highlighting for 200+ languages
• README rendering below directory listings
• File search with fuzzy matching
• Blame view with commit annotations

Commit History

Visual commit graph rendering:

• Branch and merge visualization
• Author avatars and timestamps
• Commit message search
• Diff view for any commit

Diff Viewer

• Unified and split diff modes
• Intra-line change highlighting
• Syntax-highlighted diffs
• Image diff comparison (side-by-side, onion skin, swipe)

Integrated Terminal

A terminal panel with access to drok CLI commands and Git operations. The terminal uses your system shell and inherits your PATH and environment.

Notifications

Native OS notifications for:

• Merge request reviews and comments
• Pipeline completions and failures
• Issue assignments and mentions
• Team discussions

Notification preferences are configurable per repository and event type.

Native OS Integration

macOS

• Menu bar icon with quick access to recent repositories
• Spotlight integration — search for repositories by name
• File association — .drok deep links open in the desktop app
• Touch Bar support for common actions

Linux

• System tray integration
• Desktop notifications via D-Bus
• File manager integration for repository directories
• .desktop entry for application menu

Windows

• System tray with jump list
• Windows notification center integration
• File Explorer context menu ("Open in Drok")
• Protocol handler for drok:// URLs

Keyboard Shortcuts

Auto-Update

The desktop app checks for updates on launch and can be configured to:

• Auto-update — Download and install updates automatically
• Notify — Notify when updates are available, install manually
• Manual — Check for updates only when requested

# Check for updates via CLI
drok desktop update

Configuration

Desktop app settings are stored at:

Settings sync with your Drok account when connected.