Skip to main content

Workspace settings

Settings is where your workspace is connected to the tools a task passes through. It is one track with four stations, in the order a task travels: Linear, AI models, GitHub and Team. Each station shows its status and one line of detail. Click a station to open its card.

The four stations​

StationWhat it sets upWho can change it
Linear: Tasks come fromThe Linear workspace, which teams the agent works in, and Automatic tasks for the Automatable labelOwners and admins
AI models: Agents think withThe Developer and Reviewer agents, and each person's own AI accessAgents: owners and admins. AI access: each person
GitHub: Code goes toThe GitHub App installation and the repositories the agent may changeOwners and admins
Team: People who give tasksWho may give tasks, each person's Linear link and consent, and Require human approval before releaseWorkspace settings: owners and admins. Your own link and consent: you

A station with a problem gets a highlighted ring and one callout that explains the fix.

Set up a workspace​

Until the setup is finished, the workspace opens on Settings and marks the next step. Owners and admins usually do it in this order:

  1. Connect Linear​

    Authorize the ThriveOnDev app in your Linear workspace, then optionally choose which teams it works in. See Linear integration.

  2. Connect GitHub​

    Install the ThriveOnDev GitHub App on your GitHub organization. See GitHub integration.

  3. Choose repositories​

    Pick the repositories, and the branches, the agent may change. Nothing is allowed until you choose.

  4. Each person links their own Linear user, so ThriveOnDev knows who gave a task.

  5. Add AI access​

    Each person who gives tasks adds a Claude key or a Codex sign-in. See Add your AI access.

  6. Give an agent its first task​

    Hand a small issue to the agent in Linear. See Run your first task.

Once Linear, GitHub and at least one repository are set up, the workspace opens on the Workflow board instead. A dot next to Settings in the sidebar stays until everything is done.

Change settings later​

Open the station and change what you need. Members see every station, but controls they cannot use are locked and say "Only owners and admins can change this." See Team and roles.