This guide takes you from zero to your first agent-authored pull request. You’ll create a workspace, connect a repository, and start a session.
Sign up
Create an account and sign in. You can use email and password, or Continue with GitHub / Continue with Linear to sign in with an existing account. If you were invited to a workspace, enter your invite code during sign-up.
Create your workspace
On first sign-in, the getting-started flow walks you through a short setup:
- Create workspace — give it a name; Trevize generates a URL slug (your workspace address) from it.
- Choose your style — pick a light or dark appearance (changeable later).
- Invite your team — optionally add teammates by email (you can skip this).
A workspace is your team’s home: it owns your connected repositories, members, and billing. When setup finishes you land on your workspace home.
Connect GitHub
From your workspace home, open the Connect GitHub card and install the Trevize GitHub App, then authorize the repositories you want to use.
This is what lets Trevize create branches, push code, and open pull requests on your behalf — so agent work shows up as reviewable PRs in your repo. See the GitHub integration for details.
Set up Claude Code
Open the Set up Claude Code card and add your Claude Code API token. Trevize uses it to run the coding agent that powers sessions, tasks, and automations.
Optionally, Connect Linear too, so you can turn issues into work and track it across tools.
Start your first session
Click New session to open the New collaborative session dialog and fill in:
- Title — an optional name, e.g. “Checkout redesign”.
- Repositories — the repo(s) the agent should work in.
- Base branch — the branch to start from (defaults to your repo’s default).
- Model — the agent model to use.
Choose Create session and you’ll drop into the session, where you can chat with the agent and steer it turn by turn.
Review and merge
The agent works in an isolated sandbox, checks out your repository, and implements your request on a branch. When it’s ready you get a pull request (and often a live preview) to review. Leave feedback, request changes, and merge when you’re happy — just like any other contributor.
Where to next
Concepts
Understand sessions, automations, briefs, and more in depth. Explore concepts.
Guides
Step-by-step walkthroughs for sessions, automations, and reviews. Browse guides.
Configuration
Set up hooks and previews with .trevize/settings.json.
Configure your repo.