| 1 | --- |
| 2 | title: Work |
| 3 | description: Where a workspace keeps what it means to do and sees it being done. Work items are the backlog, of any kind of work; Sessions are the work being done on them, by people and their coding agents. On the site, the phone and the native app. |
| 4 | --- |
| 5 | |
| 6 | **Work** is where a workspace keeps what it means to do, and sees it being |
| 7 | done. It has two halves: |
| 8 | |
| 9 | - **Work items** are the backlog: a feature, a bug, a chore, any kind of |
| 10 | work. Each belongs to the workspace, not to one repository, and names |
| 11 | the repositories it should land in. See [work items](/work/work-items/). |
| 12 | - **Sessions** are the work being done: each run of someone's coding |
| 13 | agent, or of g1t's, recorded as it goes, with the work items and pull |
| 14 | requests it is on. See [sessions](/work/sessions/). |
| 15 | |
| 16 | Around them, g1t keeps who is on what. A [claim](/work/claims-and-dependencies/#claims) |
| 17 | says someone is working on a work item; what it is |
| 18 | [blocked by](/work/claims-and-dependencies/#dependencies) says what has to |
| 19 | land first. A pull request opened for a work item lands it in its |
| 20 | repository when it merges, and the work item closes once every repository |
| 21 | it names has landed: see [closing work items](/work/closing/). |
| 22 | |
| 23 | People and coding agents use the same Work. An agent loads a work item's |
| 24 | whole context in one call, claims it, opens a pull request for it and is |
| 25 | recorded as a session while it works: see |
| 26 | [working with agents](/work/agents/). |
| 27 | |
| 28 | ## Where Work is |
| 29 | |
| 30 | **Work** is in the left rail, third, after **Home** and **Explore**: |
| 31 | |
| 32 | | Rail | Is | |
| 33 | | --- | --- | |
| 34 | | **Home** | What needs you, across the workspace. See [Home](/guides/home/). | |
| 35 | | **Explore** | Public repositories and people beyond your workspaces. See [Search and Explore](/guides/search/). | |
| 36 | | **Work** | Work items and sessions, at `g1t.sh/<workspace>/-/work`. | |
| 37 | |
| 38 | Then **Chat**, **Code** (for members with Code access), **Artifacts**, |
| 39 | **Routines** and the apps you pinned. Work is there for every member of |
| 40 | the workspace, Code access or not, so someone who never opens a repository |
| 41 | can still file, follow and close work. |
| 42 | |
| 43 | A repository has no Work of its own. Its work items are Work filtered to |
| 44 | it, `g1t.sh/<workspace>/-/work?repo=<name>`, and its sessions are |
| 45 | Sessions filtered to it, `g1t.sh/<workspace>/-/work/sessions?repo=<name>`. |
| 46 | A project has no Work tab of its own: from one, the command palette |
| 47 | (`Ctrl K`) has **Work** and **Sessions** filtered to it. |
| 48 | |
| 49 | ## Work's sidebar |
| 50 | |
| 51 | Work's sidebar has its work items first, then its sessions. Each row is a |
| 52 | view kept in the address, so you can share it. |
| 53 | |
| 54 | | Row | Opens | |
| 55 | | --- | --- | |
| 56 | | **Open** | The [Work list](#the-work-list): the open work items. | |
| 57 | | **Assigned to you** | The open work items assigned to you, `?assignee=<you>`. | |
| 58 | | **Closed** | The closed ones, `?state=closed`. | |
| 59 | | **Board** | The [Board](/work/board/): the backlog as it moves, from Backlog to Done. | |
| 60 | | **New work item** | A new work item; see [file a work item](/work/work-items/#file-a-work-item). | |
| 61 | | **Labels** | The workspace's [labels](/work/labels/). | |
| 62 | | **Milestones** | The workspace's [milestones](/work/milestones/). | |
| 63 | |
| 64 | Under **Sessions**: |
| 65 | |
| 66 | | Row | Opens | |
| 67 | | --- | --- | |
| 68 | | **Live now** | [Sessions](/work/sessions/): what is going now, the merge queue, what just landed and what happened. | |
| 69 | | **Every session** | Every session, most recently heard from first, live or ended. | |
| 70 | | **Yours** | The sessions you ran, `?person=<you>`. | |
| 71 | | **People's harnesses**, **Started on g1t**, **g1t's agent**, **Recorded on pull requests** | Each [kind of session](/work/sessions/#kinds-of-session) alone. | |
| 72 | |
| 73 | ## The Work list |
| 74 | |
| 75 | **Open**, at `g1t.sh/<workspace>/-/work`, lists the workspace's work |
| 76 | items. **Open** and **Closed** above it switch between the two. Each row |
| 77 | shows the work item's title, labels and number, who opened or closed it |
| 78 | and when, the repositories it links (the first two, then "+2"), its |
| 79 | milestone, its assignees, and how many pull requests and comments it has. |
| 80 | |
| 81 | Filter it by repository, by the role that repository plays (origin, |
| 82 | target or touched; see [repositories and their roles](/work/work-items/#repositories-and-their-roles)), |
| 83 | by label, milestone and assignee. On a phone they are in one **Filters** |
| 84 | sheet. The address keeps them: |
| 85 | |
| 86 | | Filter | In the address | |
| 87 | | --- | --- | |
| 88 | | State | `?state=closed` (open unless you say) | |
| 89 | | Repository | `?repo=web`, or `?repo=acme/web` | |
| 90 | | Its role | `?repo=web&role=target`: `origin`, `target` or `touched` | |
| 91 | | Label | `?label=bug` | |
| 92 | | Milestone | `?milestone=3` | |
| 93 | | Assignee | `?assignee=ana`, or `?assignee=@me` | |
| 94 | |
| 95 | `?q=` takes the same filters as words, quotes around a name with spaces: |
| 96 | `?q=is:closed label:"good first issue" repo:web role:target`. |
| 97 | |
| 98 | The list follows what changes as it happens, without reloading: a work |
| 99 | item opened, closed, labeled or commented on shows at once. |
| 100 | |
| 101 | ### Cooking now |
| 102 | |
| 103 | Above the list, **Cooking now** shows the sessions live in the workspace |
| 104 | right now, the active ones first: up to six, or three on a phone. Each |
| 105 | card has the session's title, its harness, who it runs for, its work item |
| 106 | and repository, and when it was last heard from. Filtered to a |
| 107 | repository, it shows that repository's. **Sessions** at its end opens |
| 108 | [Sessions](/work/sessions/), which has them all. With nothing running, it |
| 109 | says so. |
| 110 | |
| 111 | ## On a phone |
| 112 | |
| 113 | On the site on a phone, the bar along the bottom is **Home**, **Work**, |
| 114 | **Chat**, **Notifications** and **More**. **Work** is there for every |
| 115 | member. Tap **Work** while you are in Work and it opens Work's menu: the |
| 116 | same sidebar, work items then sessions. **More** starts with **Explore**, |
| 117 | then **Code** for members with Code access, then your other apps. |
| 118 | |
| 119 | The Work list puts its filters in one **Filters** sheet, and the |
| 120 | [Board](/work/board/) shows one column at a time. |
| 121 | |
| 122 | ## In the phone app |
| 123 | |
| 124 | The [phone app](/guides/mobile/)'s **Work** tab is the same Work, with a |
| 125 | switch at its top: **Items | Board | Sessions**. |
| 126 | |
| 127 | - **Items** is the Work list, with **Open**, **Closed** and **All** under |
| 128 | the switch. **+ New** files a work item. Tap **Work** in the bar again |
| 129 | for the filters. |
| 130 | - **Board** is the [Board](/work/board/), its columns one under another, |
| 131 | with a chip for each to show one alone. |
| 132 | - **Sessions** is [Sessions](/work/sessions/): **Everything**, **Live** |
| 133 | and **Recent**. Tap **Work** in the bar again for its filters. |
| 134 | |
| 135 | See [the phone app's Work](/guides/mobile/#work). |
| 136 | |
| 137 | ## In this section |
| 138 | |
| 139 | - [Work items](/work/work-items/): what one has, filing one, its number, |
| 140 | who sees it and its repositories. |
| 141 | - [The Board](/work/board/): the stages a work item moves through. |
| 142 | - [Closing work items](/work/closing/): how merges and commits land work |
| 143 | and close it. |
| 144 | - [Labels](/work/labels/) and [milestones](/work/milestones/). |
| 145 | - [Sessions](/work/sessions/) and [session titles](/work/session-titles/). |
| 146 | - [Claims and dependencies](/work/claims-and-dependencies/): who is on |
| 147 | what, what waits on what, and how sessions stay out of each other's way. |
| 148 | - [Working with agents](/work/agents/): the CLI, MCP and the API. |
| 149 | - [Issues became work items](/work/from-issues/): what changed for the |
| 150 | issues you had. |