Installation and Quickstart

How to install and set up Treq on your machine.

Download the latest version for your platform from the GitHub Releases page.

Platform	Release target
macOS on Apple silicon	aarch64-apple-darwin
macOS on Intel	x86_64-apple-darwin
Windows	x86_64-pc-windows-msvc
Linux	x86_64-unknown-linux-gnu

View Releases

Treq works with ordinary Git repositories. You do not need to install or learn Jujutsu to use it. Treq initializes colocated Jujutsu metadata itself when you open a repo, and it runs Git and Jujutsu operations under the hood.

Optional: install jj only for power-user debugging

Installing Jujutsu (jj) and adding it to your PATH is optional. It can help when you intentionally inspect repository state from a shell. For normal Treq use, stay in the app. Dropping to the jj CLI is not recommended as a day-to-day workflow.

Initial Setup

Click Select Repository or the folder icon, and navigate to a Git repository, selecting the folder containing .git. Using Treq with a Git repository covers what Treq writes to that folder.

Creating Your First Workspace

A workspace is where each piece of parallel work lives.

1. Click New Workspace. You can also press Cmd+N on macOS or Ctrl+N on Windows and Linux.
2. Fill in a plan title describing what you're working on.
3. Adjust the branch name if needed.
4. Click Create Workspace to save.

Starting an Agent

1. In the Code tab, write your prompt into the prompt input.
2. Submit the prompt.
3. Watch the agent terminal open and start running.
4. Open the Review tab to view the agent's changes.

Commit, Push, Merge

1. Commit changes in the Review tab.
2. Push changes to remote.
3. Optionally merge locally by clicking the Merge button.