Getting Started

Use this page to get Waqt running fast, choose your install strategy, and verify your environment.

Quick install (recommended)

One-line installers for standalone binaries:

# Linux/macOS
curl -fsSL https://raw.githubusercontent.com/GMouaad/waqt/main/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/GMouaad/waqt/main/install.ps1 | iex

Want prerelease builds? Use --prerelease in the installer or run waqt update install --prerelease.

Alternative install methods

Standalone manual download

Download platform zip assets from GitHub Releases, extract, and run waqt (or waqt.exe).

Install from source (uv)

git clone https://github.com/GMouaad/waqt.git
cd waqt
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

Dev container

Use the repository devcontainer for a reproducible dev setup with dependencies pre-provisioned.

First commands

waqt --version
waqt ui
waqt start --time 09:00 --description "Morning deep work"
waqt end --time 17:30
waqt summary
waqt export --period week

Update channels

waqt update check to check stable updates.
waqt update check --prerelease for dev channel updates.
waqt update install to install latest stable executable.

Next steps

← Back to hub Next: Core time tracking →