Docs: Sessions is a section of Work, and Explore is second in the rail
- G1T-Session:
- ses_01m56vafhge7ttrgs5288dpxvb
9 files+56−520/9 viewed
| 5 | 5 | ||
| 6 | 6 | Issues used to belong to one repository each. They are now | |
| 7 | 7 | [work items](/guides/work-items/), which belong to the workspace and can | |
| 8 | − | link several repositories. **Work**, after **Home** in the left rail, | |
| 9 | − | replaces each repository's **Issues** tab. | |
| 8 | + | link several repositories. **Work**, after **Home** and **Explore** in | |
| 9 | + | the left rail, replaces each repository's **Issues** tab. | |
| 10 | 10 | ||
| 11 | 11 | ## What happened to your issues | |
| 12 | 12 | ||
| ⋯ | |||
| 43 | 43 | - `Closes #12` in history still points at the right work item. | |
| 44 | 44 | - A repository has no **Work** or **Sessions** page of its own, and | |
| 45 | 45 | `g1t.sh/<owner>/<repo>/work` and `…/sessions` are not found. Its claims | |
| 46 | − | and sessions are on the workspace's | |
| 46 | + | and sessions are on Work's | |
| 47 | 47 | [Sessions](/guides/sessions/#the-sessions-page), filtered to it: | |
| 48 | − | `g1t.sh/<workspace>/-/sessions?repo=<name>`. A session's page is | |
| 49 | − | `g1t.sh/<workspace>/-/sessions/<id>`, and a pull request's recorded | |
| 48 | + | `g1t.sh/<workspace>/-/work/sessions?repo=<name>`. A session's page is | |
| 49 | + | `g1t.sh/<workspace>/-/work/sessions/<id>`, and a pull request's recorded | |
| 50 | 50 | session is its **Session** tab, `…/pull/<number>/session`. | |
| 51 | 51 | ||
| 52 | 52 | ## Labels and milestones | |
| 36 | 36 | ||
| 37 | 37 | A work item says what should change. People open them, coding agents open | |
| 38 | 38 | them, and so can anything with an access token, such as an error tracker | |
| 39 | − | reporting a crash. They are under **Work**, after **Home** in the left | |
| 40 | − | rail; see [work items](/guides/work-items/). | |
| 39 | + | reporting a crash. They are under **Work**, after **Home** and | |
| 40 | + | **Explore** in the left rail; see [work items](/guides/work-items/). | |
| 41 | 41 | ||
| 42 | 42 | A work item has: | |
| 43 | 43 | ||
| ⋯ | |||
| 221 | 221 | the `session` tool or `g1t session`. A session is recorded in the repository it | |
| 222 | 222 | is checked out in, and tied to the work item it claimed and the pull | |
| 223 | 223 | request it opened. People read it on the pull request's **Session** tab, | |
| 224 | − | on the work item, and on the workspace's **Sessions**, in the rail after | |
| 225 | − | **Work**, which shows who is working on what right now across its | |
| 226 | − | repositories. See | |
| 224 | + | on the work item, and in **Work**'s **Sessions** | |
| 225 | + | (`g1t.sh/<workspace>/-/work/sessions`), which shows who is working on | |
| 226 | + | what right now across its repositories. See | |
| 227 | 227 | [sessions, claims and dependencies](/guides/sessions/). | |
| 228 | 228 | ||
| 229 | 229 | Each entry is tied to the commit that was the head when it was recorded, | |
| 51 | 51 | | Tab | What is on it | | |
| 52 | 52 | | --- | --- | | |
| 53 | 53 | | **Home** | Coming. Opens Home on the site meanwhile. | | |
| 54 | − | | **Work** | The workspace's work items and their Board, for every member, Code access or not. **Sessions** opens from the icon in its header. See [Work](#work). | | |
| 54 | + | | **Work** | The workspace's work items, their Board and the sessions working on them: **Items**, **Board** and **Sessions** at its top. For every member, Code access or not. See [Work](#work) and [Sessions](#sessions). | | |
| 55 | 55 | | **Chat** | Your starred conversations, channels and direct messages, with what is unread, moving live. See [Chat](#chat). | | |
| 56 | 56 | | **Notifications** | Coming. Opens your notifications on the site meanwhile; messages to you already arrive [on the phone](#notifications). | | |
| 57 | − | | **More** | **Sessions** first (see [Sessions](#sessions)), then **Code**, for members with Code access; whether this phone gets notifications, your workspaces, how you signed in, and **Sign out**. | | |
| 57 | + | | **More** | **Explore** first, which opens on the site, then **Code**, for members with Code access; whether this phone gets notifications, your workspaces, how you signed in, and **Sign out**. | | |
| 58 | 58 | ||
| 59 | 59 | **Code**, under **More**, is the workspace's repositories, each with its | |
| 60 | 60 | pull requests and its **Work**: the work items linked to it. A pull | |
| ⋯ | |||
| 94 | 94 | ||
| 95 | 95 | ## Sessions | |
| 96 | 96 | ||
| 97 | − | **Sessions** is the site's [Sessions](/guides/sessions/#the-sessions-page): | |
| 98 | − | the sessions at work across the workspace. Open it from the icon in | |
| 99 | − | Work's header, or first in **More**. | |
| 97 | + | **Sessions** is the site's [Sessions](/guides/sessions/#the-sessions-page), | |
| 98 | + | a section of Work: the sessions at work across the workspace. Choose | |
| 99 | + | **Sessions** at the top of **Work**, beside **Items** and **Board**. | |
| 100 | 100 | ||
| 101 | 101 | - **Everything**, **Live** and **Recent** at the top choose what it | |
| 102 | 102 | lists. Pull down to read it again. | |
| ⋯ | |||
| 183 | 183 | | `g1t://<workspace>/-/work/<number>` | The work item | | |
| 184 | 184 | | `g1t://<workspace>/-/work/new` | A new work item | | |
| 185 | 185 | | `g1t://<workspace>/-/work/board` | Work, on the Board | | |
| 186 | − | | `g1t://<workspace>/-/sessions` | Sessions | | |
| 187 | − | | `g1t://<workspace>/-/sessions/<id>` | The session | | |
| 186 | + | | `g1t://<workspace>/-/work/sessions`, with its filters (`?state=live&repo=web`) | Work, on Sessions | | |
| 187 | + | | `g1t://<workspace>/-/work/sessions/<id>` | The session | | |
| 188 | 188 | | `g1t://<workspace>/-/chat`, `…/-/chat/<channel>`, `…/-/chat/dm/<id>` | Chat, or the conversation, in that workspace | | |
| 189 | 189 | | `g1t://<owner>/<repo>` | The repository | | |
| 190 | 190 | | `g1t://<owner>/<repo>/pull/<number>` | The pull request | | |
| ⋯ | |||
| 192 | 192 | ||
| 193 | 193 | The same paths as `https://g1t.sh/…` links, such as | |
| 194 | 194 | `https://g1t.sh/<workspace>/-/work/<number>` or | |
| 195 | − | `https://g1t.sh/<workspace>/-/sessions/<id>`, open these screens once | |
| 195 | + | `https://g1t.sh/<workspace>/-/work/sessions/<id>`, open these screens once | |
| 196 | 196 | g1t.sh publishes the files Android and iOS check first (see | |
| 197 | 197 | [below](#whats-not-there-yet)). The workspace's labels and milestones open | |
| 198 | 198 | on the site. | |
| 207 | 207 | | **Tags** | A tag is pushed or deleted, or a release is published. | | |
| 208 | 208 | | **Pull requests** | One is opened, updated, reviewed, commented on, checked, merged or closed. | | |
| 209 | 209 | | **Work**, filtered or not, and its **Board** | Any of the workspace's work items is opened, changed, labeled, linked, claimed, commented on, closed or reopened. | | |
| 210 | − | | **Sessions** | A session in one of the workspace's repositories starts, records or ends. | | |
| 210 | + | | Work's **Sessions** | A session in one of the workspace's repositories starts, records or ends. | | |
| 211 | 211 | | A **pull request** | Commits are pushed to it, its checks report, someone reviews or comments, or it is merged or closed. New items join its timeline where you are reading; if you are at the end of the page, it follows them down. | | |
| 212 | 212 | | A **work item** | Someone comments on it or changes it, links a repository, claims it, or a pull request for it lands. If you are at the end of the page, it follows new items down. | | |
| 213 | 213 | | **Actions** and a **run** | A run starts, one of its jobs starts or finishes, or the run finishes. A running job's log streams on its own. | |
| 39 | 39 | | **Code** | `…/code` | The repository's files, commits and branches. | | |
| 40 | 40 | | **Work** | `g1t.sh/<workspace>/-/work?repo=<name>` | The workspace's [work items](/guides/work-items/) linked to the repository. | | |
| 41 | 41 | | **Pull requests**, **Merge queue** | `…/pulls` and so on | As they always were. A pull request's **Session** tab is at `…/pull/<number>/session`. | | |
| 42 | − | | **Sessions** | `g1t.sh/<workspace>/-/sessions?repo=<name>` | The workspace's [sessions](/guides/sessions/#the-sessions-page) in the repository. | | |
| 42 | + | | **Sessions** | `g1t.sh/<workspace>/-/work/sessions?repo=<name>` | The workspace's [sessions](/guides/sessions/#the-sessions-page) in the repository. | | |
| 43 | 43 | | **Actions** | `…/actions` | [GitHub Actions workflows](/guides/actions/). | | |
| 44 | 44 | | **Deployments** | `…/deployments` | What is up now and every build. | | |
| 45 | 45 | | **Settings** | `…/settings` | See below. | | |
| ⋯ | |||
| 73 | 73 | | **Facts** | Under production: its latest release (or, where the card does not already say it, production's state), how often checks pass, and either how many changes pass on the first try and what is open, or, for people with a role when [Observability](/guides/observability/) has data, requests and the error rate over the last day with how many errors are open. | | |
| 74 | 74 | | **Code** | One line to the repository: its name, default branch and when it was last pushed to, linking to **Code**. | | |
| 75 | 75 | | **Needs you** | For someone signed in: what is waiting on them, such as a failed production build or a pull request to merge or review. | | |
| 76 | − | | **Live now** | The people and coding agents working on it: each work item with its [claims and sessions](/guides/sessions/), the harness each came from and who it acts for, and sessions on no work item yet. The workspace's [Sessions](/guides/sessions/#the-sessions-page), filtered to the repository (`g1t.sh/<workspace>/-/sessions?repo=<name>`), has everything. With nobody working, people with a role see how to [connect a coding agent](/guides/bring-your-own-agent/). | | |
| 76 | + | | **Live now** | The people and coding agents working on it: each work item with its [claims and sessions](/guides/sessions/), the harness each came from and who it acts for, and sessions on no work item yet. Work's [Sessions](/guides/sessions/#the-sessions-page), filtered to the repository (`g1t.sh/<workspace>/-/work/sessions?repo=<name>`), has everything. With nobody working, people with a role see how to [connect a coding agent](/guides/bring-your-own-agent/). | | |
| 77 | 77 | | **Previews** | For people with a role: the pull requests' previews that are up. | | |
| 78 | 78 | | **Deployments** | Each environment's latest deployment and when. | | |
| 79 | 79 | | **Observability** | For people with a role, when there is data: the last day's requests, an hour a bar, latency, and the newest open errors. | | |
| 31 | 31 | ||
| 32 | 32 | ## The Sessions page | |
| 33 | 33 | ||
| 34 | − | **Sessions** is in the left rail, directly after **Work**, at | |
| 35 | − | `g1t.sh/<workspace>/-/sessions`. It shows what is cooking across the | |
| 36 | − | workspace: the sessions in every one of its repositories you can read, | |
| 37 | − | as they happen, without reloading. | |
| 34 | + | **Sessions** is a section of [Work](/guides/work-items/), at | |
| 35 | + | `g1t.sh/<workspace>/-/work/sessions`: sessions are the work being done on | |
| 36 | + | work items, so they live with them. Work's sidebar has it under its | |
| 37 | + | **Sessions** heading, after the work items: **Live now**, **Recent**, | |
| 38 | + | **Yours**, then each kind (**People's harnesses**, **Started on g1t**, | |
| 39 | + | **g1t's agent** and **Recorded on pull requests**). It shows what is | |
| 40 | + | cooking across the workspace: the sessions in every one of its | |
| 41 | + | repositories you can read, as they happen, without reloading. | |
| 38 | 42 | ||
| 39 | 43 | - **Live now**: the active and idle sessions, the most recently heard | |
| 40 | 44 | from first. Each card shows the session's title, who it acts for, its | |
| ⋯ | |||
| 62 | 66 | harness (`?harness=codex`), kind (`?kind=hosted`) and state. The address | |
| 63 | 67 | keeps the filters, so a filtered view can be shared. A repository's | |
| 64 | 68 | sessions are Sessions filtered to it, | |
| 65 | − | `g1t.sh/<workspace>/-/sessions?repo=<name>`: a repository has no | |
| 69 | + | `g1t.sh/<workspace>/-/work/sessions?repo=<name>`: a repository has no | |
| 66 | 70 | Sessions page of its own. | |
| 67 | 71 | ||
| 68 | 72 | Every kind of session is listed in this one place: | |
| ⋯ | |||
| 74 | 78 | | `agent` | g1t's own agent at work on a pull request. Only the workspace's members see these. | | |
| 75 | 79 | | `recorded` | A session recorded on a pull request with no session of its own. It opens on the pull request's **Session** tab, `g1t.sh/<owner>/<repo>/pull/<number>/session`. | | |
| 76 | 80 | ||
| 77 | − | **A session's page** is `g1t.sh/<workspace>/-/sessions/<id>` (the | |
| 81 | + | **A session's page** is `g1t.sh/<workspace>/-/work/sessions/<id>` (the | |
| 78 | 82 | `ses_…` id), opened from Sessions or from anywhere the session is listed: | |
| 79 | 83 | who ran it, in which harness and on which model, how long it has run, its | |
| 80 | 84 | repository, the work items and pull requests it and its subagents worked | |
| 8 | 8 | service, its client and its docs is one item, with one number, one | |
| 9 | 9 | conversation and one place that says what is done. | |
| 10 | 10 | ||
| 11 | − | **Work** is in the left rail, directly after **Home**, at | |
| 11 | + | **Work** is in the left rail, after **Home** and **Explore**, at | |
| 12 | 12 | `g1t.sh/<workspace>/-/work`. A work item's page is | |
| 13 | − | `g1t.sh/<workspace>/-/work/<number>`. Work is the work items: the | |
| 14 | − | [list](#the-work-list), the [Board](#the-board), **New work item**, | |
| 15 | − | **Labels** and **Milestones**. The sessions working on them are in | |
| 16 | − | [Sessions](/guides/sessions/#the-sessions-page), right after Work in the | |
| 17 | − | rail. | |
| 13 | + | `g1t.sh/<workspace>/-/work/<number>`. Work has two sections. **Work | |
| 14 | + | items**: the [list](#the-work-list), the [Board](#the-board), **New work | |
| 15 | + | item**, **Labels** and **Milestones**. **Sessions**: the sessions working | |
| 16 | + | on them, at `g1t.sh/<workspace>/-/work/sessions` (see | |
| 17 | + | [the Sessions page](/guides/sessions/#the-sessions-page)). | |
| 18 | 18 | ||
| 19 | 19 | Work items used to be issues, one repository's each. [Issues became work | |
| 20 | 20 | items](/about/issues-became-work-items/) says what changed for the ones you | |
| ⋯ | |||
| 135 | 135 | `g1t.sh/<workspace>/-/work?repo=<name>`. | |
| 136 | 136 | ||
| 137 | 137 | Above the list, **Cooking now** is a strip of the sessions live in the | |
| 138 | − | workspace right now; it links to [Sessions](/guides/sessions/#the-sessions-page), | |
| 139 | − | which has them all. | |
| 138 | + | workspace right now; it links to Work's | |
| 139 | + | [Sessions](/guides/sessions/#the-sessions-page), which has them all. | |
| 140 | 140 | ||
| 141 | − | Work's sidebar has **Open**, **Assigned to you** and **Closed**, then | |
| 142 | − | **Board**, **New work item**, **Labels** and **Milestones**. On a phone, | |
| 143 | − | the bar along the bottom is **Home**, **Work**, **Chat**, | |
| 144 | − | **Notifications** and **More**, with **Work** there for every member, | |
| 145 | − | Code access or not. **More** starts with **Sessions**, then **Code**. | |
| 146 | − | Tapping **Work** again opens its menu: **Open**, **Assigned to you**, | |
| 147 | − | **Closed**, **Board**, **Sessions**, **New work item**, **Labels** and | |
| 148 | − | **Milestones**. | |
| 141 | + | Work's sidebar has two sections. **Work items**: **Open**, **Assigned to | |
| 142 | + | you** and **Closed**, then **Board**, **New work item**, **Labels** and | |
| 143 | + | **Milestones**. **Sessions**: **Live now**, **Recent** and **Yours**, then | |
| 144 | + | each kind of session. On a phone, the bar along the bottom is **Home**, | |
| 145 | + | **Work**, **Chat**, **Notifications** and **More**, with **Work** there | |
| 146 | + | for every member, Code access or not. Tapping **Work** again opens its | |
| 147 | + | menu, the same two sections. **More** starts with **Explore**, then | |
| 148 | + | **Code**. | |
| 149 | 149 | ||
| 150 | 150 | ## The Board | |
| 151 | 151 | ||
| ⋯ | |||
| 193 | 193 | see [sessions, claims and dependencies](/guides/sessions/). A session is | |
| 194 | 194 | recorded in the repository it is checked out in, and the work item it | |
| 195 | 195 | works on is the workspace's. A work item's page lists the sessions on | |
| 196 | − | it; **Sessions**, in the rail, lists every session in the workspace. | |
| 196 | + | it; Work's **Sessions** lists every session in the workspace. | |
| 197 | 197 | ||
| 198 | 198 | To open a pull request for a work item, use `g1t pr create --item 12`, or | |
| 199 | 199 | the `pull_request` tool's `create` with `item: 12`. The pull request's | |
| 690 | 690 | that project's own list, as in Code, with **Projects** at its top to go | |
| 691 | 691 | back to the rest of theirs. A project shared with you stays in Code, under | |
| 692 | 692 | **Shared with you**. On a phone, the button at the top left opens the same | |
| 693 | − | sidebar, and **More** has **Explore**. | |
| 693 | + | sidebar, and **More** starts with **Explore**. | |
| 694 | 694 | ||
| 695 | 695 | Each page has three parts: | |
| 696 | 696 | ||
| 697 | 697 | | Part | Where | What it holds | | |
| 698 | 698 | | --- | --- | --- | | |
| 699 | − | | **The rail** | A narrow column of icons down the left edge | g1t's mark, which goes to [Home](/guides/home/); the built-in apps, with **Explore** after **Work** and **Sessions**; the apps you pinned; and at its foot **Apps**, **People**, **Workspace** and your account. Hold the pointer over an icon for its name. | | |
| 699 | + | | **The rail** | A narrow column of icons down the left edge | g1t's mark, which goes to [Home](/guides/home/); the built-in apps, **Home**, **Explore**, **Work**, **Chat**, **Code**, **Artifacts** and **Routines**; the apps you pinned; and at its foot **Apps**, **People**, **Workspace** and your account. Hold the pointer over an icon for its name. | | |
| 700 | 700 | | **The sidebar** | Flush against the rail | The workspace and its switcher at the top, **Search or jump to**, then the lists of the app you are in, in named groups. Home has none. | | |
| 701 | 701 | | **The page** | The rest of the window, flat against the sidebar | Its header: the button that shows or hides the sidebar, where you are, **Search or jump to** (<kbd>Ctrl</kbd> <kbd>K</kbd>, or <kbd>⌘</kbd> <kbd>K</kbd> on a Mac) when the sidebar is hidden or has a search of its own, the [notifications](/guides/notifications/) bell and **Create new**. Then the page itself. | | |
| 702 | 702 | ||
| ⋯ | |||
| 708 | 708 | | App | Opens | | |
| 709 | 709 | | --- | --- | | |
| 710 | 710 | | **Home** | Where you're needed across the workspace, and what happened while you were away. See [Home](/guides/home/). | | |
| 711 | − | | **Work** | The workspace's work items, their [Board](/guides/work-items/#the-board), and its labels and milestones, at `g1t.sh/<workspace>/-/work`. Every member has it, with Code access or not. See [work items](/guides/work-items/). | | |
| 712 | − | | **Sessions** | What is cooking across the workspace: the sessions live now in every repository you can read, the merge queues, what just landed and what happened, at `g1t.sh/<workspace>/-/sessions`. See [the Sessions page](/guides/sessions/#the-sessions-page). | | |
| 713 | 711 | | **Explore** | g1t beyond your workspaces: public projects, people and other workspaces. | | |
| 712 | + | | **Work** | The workspace's work items, their [Board](/guides/work-items/#the-board), and its labels and milestones, at `g1t.sh/<workspace>/-/work`; and its **Sessions**, what is cooking across the workspace (the sessions live now in every repository you can read, the merge queues, what just landed and what happened), at `g1t.sh/<workspace>/-/work/sessions`. Every member has it, with Code access or not. See [work items](/guides/work-items/) and [the Sessions page](/guides/sessions/#the-sessions-page). | | |
| 714 | 713 | | **Chat** | Channels and messages. See [Chat](/guides/chat/). | | |
| 715 | 714 | | **Code** | Projects, pull requests and checks. Not shown to a member without Code access. | | |
| 716 | 715 | | **Artifacts** | Documents, decks and pages. See [artifacts](/guides/artifacts/). | | |
| ⋯ | |||
| 879 | 878 | | | What it does | | |
| 880 | 879 | | --- | --- | | |
| 881 | 880 | | **The bar along the bottom** | **Home**, **Work**, **Chat** and **Notifications**, each with what is unread, and **More**. Work is there for every member, with Code access or not. It runs flat along the bottom edge, as the rail stands beside the page on a computer, and the page fills the screen above it. The app you are in is marked as on the rail. It steps aside while the keyboard is up and inside a conversation. | | |
| 882 | − | | **More** | A panel above the bar with **Sessions** first, then **Code** (for members with Code access), **All apps** and the apps you pinned, **Artifacts**, **Routines**, **People**, **Workspace**, **Explore**, and **You and help**: your status, profile and settings, [appearance](#appearance), the documentation, support, status, the keyboard's shortcuts and signing out. | | |
| 881 | + | | **More** | A panel above the bar with **Explore** first, then **Code** (for members with Code access), **All apps** and the apps you pinned, **Artifacts**, **Routines**, **People**, **Workspace**, and **You and help**: your status, profile and settings, [appearance](#appearance), the documentation, support, status, the keyboard's shortcuts and signing out. | | |
| 883 | 882 | | **The sidebar button**, at the left of the page's header | Opens the sidebar of the app you are in from the left, most of the screen wide: the same lists and links as on a computer. Tap outside it, or open a page, and it closes. | | |
| 884 | − | | **The tab you are already on** | Tap it again to open that app's sidebar too: for **Work**, **Open**, **Assigned to you**, **Closed**, **Board**, **Sessions**, **New work item**, **Labels** and **Milestones**. | | |
| 883 | + | | **The tab you are already on** | Tap it again to open that app's sidebar too: for **Work**, its two sections: **Work items** (**Open**, **Assigned to you**, **Closed**, **Board**, **New work item**, **Labels** and **Milestones**) and **Sessions** (**Live now**, **Recent**, **Yours** and each kind). | | |
| 885 | 884 | | **The workspace's name** in the page's header | Switches workspace, or opens your profile or settings. | | |
| 886 | 885 | ||
| 887 | 886 | Inside a [project](/guides/projects/), its pages (**Overview**, **Code**, | |
| 103 | 103 | ## The workspace | |
| 104 | 104 | ||
| 105 | 105 | Everything happens in a workspace: your company, or one team in it. The | |
| 106 | − | rail down the left holds Home, Chat, Notifications, Code and Artifacts, | |
| 107 | − | the apps you pin, and People, Workspace and your account at its foot. On | |
| 106 | + | rail down the left holds Home, Explore, Work (with its sessions), Chat, | |
| 107 | + | Code, Artifacts and Routines, the apps you pin, and Apps, People, | |
| 108 | + | Workspace and your account at its foot. On | |
| 108 | 109 | a phone it is a bar along the bottom. | |
| 109 | 110 | ||
| 110 | 111 | | Feature | What it does | Status | |
Comments
Sign in to comment.