Getting
Started

Install Taskeract, configure your first agent, and start orchestrating.

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 tap acqusys/taskeract && brew install --cask taskeract

Note: Taskeract is not yet code-signed or notarized with Apple. If macOS reports the app is "damaged," remove the quarantine attribute:

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 handles everything that needs administrator privileges so you only see one prompt.

1. Sign In

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

2. Welcome

The wizard shows what it will set up: trusted HTTPS so browsers accept your local development sites, custom .tact domains so each session gets its own web address, and standard port access so URLs don't need extra port numbers. On Pro plans, it also prepares your system for agent sandboxing.

3. Agent Selection

Taskeract detects supported AI coding agents installed on your system and pre-selects any it finds. You can toggle which agents to configure.

4. System Setup

The wizard configures your system so everything works out of the box. This requires administrator privileges -- you'll be prompted for your password once or twice depending on your platform.

On macOS, Chrome and Firefox need the nss package to trust your .tact domains. If you installed Taskeract with Homebrew, this is handled automatically. Otherwise, run brew install nss and restart the app. Safari works without it.

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.

GettingStarted