Installation

Homebrew (macOS and Linux)

The recommended way to install taskmd:

# Add the tap
brew tap driangle/tap

# Install taskmd
brew install taskmd

# Verify installation
taskmd --version

Pre-built Binaries

Download from the GitHub releases page:

# Download the archive for your platform
# Extract it
tar -xzf taskmd-v*.tar.gz  # macOS/Linux
# or unzip for Windows

# Move to a directory in your PATH
sudo mv taskmd /usr/local/bin/  # macOS/Linux

Available platforms:

• Linux: AMD64, ARM64
• macOS: AMD64 (Intel), ARM64 (Apple Silicon)
• Windows: AMD64

Docker

The Docker image includes the full CLI and the embedded web dashboard. No Go or Node.js required.

Web dashboard (default):

docker run --rm -p 8080:8080 -v ./tasks:/tasks:ro ghcr.io/driangle/taskmd

Open http://localhost:8080 to view the dashboard.

CLI commands:

docker run --rm -v ./tasks:/tasks ghcr.io/driangle/taskmd taskmd list
docker run --rm -v ./tasks:/tasks ghcr.io/driangle/taskmd taskmd next

Custom port:

docker run --rm -p 3000:3000 -e TASKMD_WEB_PORT=3000 -v ./tasks:/tasks:ro ghcr.io/driangle/taskmd

With docker-compose:

services:
  taskmd:
    image: ghcr.io/driangle/taskmd
    ports:
      - "8080:8080"
    volumes:
      - ./tasks:/tasks:ro

Install with Go

Requires Go 1.22 or later:

go install github.com/driangle/taskmd/apps/cli/cmd/taskmd@latest

Make sure $GOPATH/bin is in your PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Build from Source

# Clone repository
git clone https://github.com/driangle/taskmd.git
cd taskmd/apps/cli

# Build CLI only
make build

# Build with embedded web interface
make build-full

# Binary will be at ./taskmd

Verify Installation

taskmd --version
taskmd --help

Next Steps

• Quick Start - Create your first project
• Core Concepts - Understand the fundamentals