Installation and Quickstart

How to install and set up Treq on your machine.

Download the latest version for macOS from the GitHub Releases page.

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.

Creating Your First Workspace

1. Click New Workspace (or press Cmd+N) to open the creation dialog.
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.