Getting
Started

Prerequisites

Before installing Taskeract, make sure you have the following:

• Git — Taskeract uses git worktrees to isolate agent sessions. Git 2.20 or later is required.
• An AI coding agent — At least one supported agent must be installed: Claude Code, OpenAI Codex CLI, or OpenCode. Taskeract uses the credentials you've already configured for each agent, so make sure you're logged in and authenticated before adding them.
• A Taskeract account — Sign up at taskeract.com/sign-up to activate your license.

Taskeract runs on Linux, macOS, and Windows.

Install

Choose the installation method that matches your system.

Homebrew (macOS)

brew install --cask taskeract

xattr -cr /Applications/Taskeract.app

AUR (Arch Linux)

yay -S taskeract

APT (Debian / Ubuntu)

Add the Taskeract repository and install:

curl -fsSL https://f001.backblazeb2.com/file/taskeract-pub/gpg/taskeract-repo.gpg.key \
  | sudo gpg --dearmor -o /usr/share/keyrings/taskeract.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/taskeract.gpg] \
  https://f001.backblazeb2.com/file/taskeract-pub/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/taskeract.list
sudo apt update && sudo apt install taskeract

DNF (Fedora / RHEL)

Add the Taskeract repository and install:

sudo rpm --import https://f001.backblazeb2.com/file/taskeract-pub/gpg/taskeract-repo.gpg.key
sudo tee /etc/yum.repos.d/taskeract.repo << 'EOF'
[taskeract]
name=Taskeract
baseurl=https://f001.backblazeb2.com/file/taskeract-pub/yum/x86_64
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://f001.backblazeb2.com/file/taskeract-pub/gpg/taskeract-repo.gpg.key
EOF
sudo dnf install taskeract

winget (Windows)

winget install Acqusys.Taskeract

.exe (Windows)

Download the installer from the download page and run it. No administrator privileges are required.

First Launch

When you launch Taskeract for the first time, a setup wizard walks you through configuring your system. The wizard sets up a local domain system so each project's sessions are accessible via https://*.tact URLs.

1. Sign In

Enter your Taskeract account credentials. This activates your license and syncs your subscription status.

2. Welcome

The wizard explains what will be configured: a local Certificate Authority, system trust store installation, DNS resolver, DNS server, HTTPS proxy, and port 443 access.

3. Agent Selection

Taskeract scans your system for supported AI coding agents and pre-selects any it finds on your PATH. You can toggle which agents to configure. Each agent is assigned a unique display color.

4. Domain System Setup

The wizard configures your system so each project's sessions are accessible via trusted .tact domains. This requires a few privileged operations — you'll be prompted for your password once or twice depending on your platform.

Adding Your First Project

A project in Taskeract is a pointer to a local git repository backed by a remote on GitHub, GitLab, or Bitbucket. The welcome screen offers three ways to add one:

• Clone Repository — browse and clone a repository from a connected account. You can also paste a repository URL directly. See Accounts for how to connect your accounts.
• Import Folder — select a local folder. If it already has a remote matching a connected account, it's imported directly. Otherwise, a wizard walks you through creating a new repository. Also available from File > Import Folder.
• Create New — create a brand-new repository on your hosting provider, with a local clone set up automatically.

The project is added using the directory name. Taskeract auto-detects the development branch from the remote so new sessions are branched from the right place. To customize this or other settings, click on the project in the sidebar to open the Project Properties view, which provides tabs for general settings, worktree configuration, and git options.

Once the project is added, you can create your first session. See the Usage Guide for details on sessions, agents, and git integration.