Getting StartedInstallation

Installation

Install the Drok CLI, Desktop App, and configure your development environment.

Drok provides three client interfaces: the CLI for terminal-native workflows, the Desktop App for offline-capable GUI workflows, and the Web Editor for browser-based development. Each is independently functional. Use whichever matches your workflow — or all three.

CLI

The drok command-line interface is a Rust binary. It is faster than gh for every equivalent operation because it is compiled, not interpreted, and because it was designed by engineers who understand that CLI performance is not optional.

brew install drok/tap/drok
curl -fsSL https://drok.us/install.sh | sh
sudo apt-get install drok
curl -fsSL https://drok.us/install.sh | sh
winget install drok.drok
cargo install drok-cli

Requires Rust 1.75+ and a C compiler for libgit2 bindings.

Configuration

After installation, authenticate and set your default preferences:

drok auth login
drok config set editor vim
drok config set default-branch main
drok config set protocol ssh

Configuration is stored at ~/.config/drok/config.toml.

Desktop App

The Drok Desktop App is built on Tauri v2 — a Rust-native application framework that produces binaries smaller than Electron alternatives by an order of magnitude. The desktop app works offline. Clone, commit, diff, and browse repositories without an internet connection.

Download from drok.us/download/mac or:

brew install --cask drok

Download the AppImage from drok.us/download/linux or install via your package manager.

Download from drok.us/download/windows or:

winget install drok.desktop

Desktop Features

  • Full repository browsing and file editing
  • Integrated diff viewer with unified and split modes
  • Commit history graph visualization
  • Offline mode — work without internet, sync when connected
  • Native OS integration (notifications, file associations, deep links)

SSH Keys

Configure SSH access for Git operations:

drok ssh-key add ~/.ssh/id_ed25519.pub

Or generate a new key pair:

ssh-keygen -t ed25519 -C "your-email@example.com"
drok ssh-key add ~/.ssh/id_ed25519.pub

Drok also supports post-quantum SSH key exchange for organizations that require quantum-resistant transport security. See Post-Quantum Cryptography for configuration details.

GPG Signing

Configure commit signing:

drok gpg-key add /path/to/public-key.asc
git config --global commit.gpgsign true
git config --global user.signingkey YOUR_KEY_ID

Signed commits display a verification badge in the Drok web interface.