| 1 | --- |
| 2 | title: Issues became work items |
| 3 | description: Issues moved out of repositories into workspace-level work items. What happened to the issues, labels and milestones you had, why old links still work, and what to change in scripts and agents. |
| 4 | --- |
| 5 | |
| 6 | Issues used to belong to one repository each. They are now |
| 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. |
| 10 | |
| 11 | ## What happened to your issues |
| 12 | |
| 13 | Every issue became a work item, with everything it had: its title and |
| 14 | description, comments, reactions, labels, assignees, milestone, claims, |
| 15 | sessions, pull requests and what it was blocked by. |
| 16 | |
| 17 | - **It has a new number.** Work items are numbered once for the whole |
| 18 | workspace, and each issue was given the next number, oldest first, above |
| 19 | every number any of the workspace's repositories had used. So an issue |
| 20 | number and a work item number never mean two things. |
| 21 | - **Its repository is its origin.** The work item links the repository |
| 22 | the issue was in as its `origin`, and keeps the old number there. Its |
| 23 | pull requests' repositories are linked as `touched`. |
| 24 | - **Pull requests kept their numbers.** New ones take the workspace's next |
| 25 | number. |
| 26 | - **Who can see it did not change.** Anyone who could read the repository |
| 27 | still sees the work item filed there. Members of the workspace now see |
| 28 | every work item in it. |
| 29 | |
| 30 | ## Old links still work |
| 31 | |
| 32 | - `g1t.sh/<owner>/<repo>/issues/12` redirects to the work item that issue |
| 33 | became, at `g1t.sh/<owner>/-/work/<number>`. **Issues**, **New issue**, |
| 34 | **Labels** and **Milestones** under a repository redirect to **Work**. |
| 35 | - `#12` and `owner/repo#12` in descriptions, comments and commit messages |
| 36 | written before still link to that issue's work item. |
| 37 | - `Closes #12` in history still points at the right work item. |
| 38 | - A repository's old **Work** page, its claims and sessions, is now its |
| 39 | **Sessions** page, and the old address redirects there. |
| 40 | |
| 41 | ## Labels and milestones |
| 42 | |
| 43 | Labels and milestones now belong to the workspace, too. |
| 44 | |
| 45 | - Labels with the same name in several repositories became one label. The |
| 46 | one made first kept its color and description. |
| 47 | - Milestones were renumbered in the workspace. Each records the |
| 48 | repository it came from, and every work item and pull request in it |
| 49 | stayed in it. |
| 50 | |
| 51 | ## What to change |
| 52 | |
| 53 | Nothing that reads links or references needs to change. What calls g1t by |
| 54 | name does: |
| 55 | |
| 56 | | Was | Now | |
| 57 | | --- | --- | |
| 58 | | `g1t issue …` | `g1t work …`: `list`, `view`, `new`, `edit`, `close`, `reopen` | |
| 59 | | `g1t work context N` | `g1t work view N` | |
| 60 | | `g1t work list` (claims and sessions) | `g1t work status` | |
| 61 | | `--issue N` on `g1t pr create`, `g1t session …` and `g1t work events` | `--item N` | |
| 62 | | The MCP `issue` tool | `work_item`, with `workspace` and `number` | |
| 63 | | `pull_request` `create` with `issue` | `pull_request` `create` with `item` | |
| 64 | | `/repos/{owner}/{name}/issues…` | `/workspaces/{workspace}/work…` | |
| 65 | | Repository labels and milestones routes | `/workspaces/{workspace}/labels` and `/workspaces/{workspace}/milestones` | |
| 66 | | `issue.*` events and webhooks | `work_item.*`. Webhooks you had were moved over for you. | |
| 67 | | `issues:read`, `issues:write` scopes | `work:read`, `work:write` | |
| 68 | | `/g1t:work-on-issue` in Claude Code | `/g1t:work-on-item`, with the plugin 0.3.0 and the CLI 0.4.0 or later | |
| 69 | |
| 70 | There are no aliases for the old names: a script that calls one gets an |
| 71 | error, not a silent change. Numbers in your own data, such as a tracker |
| 72 | that stored `owner/repo#12`, still resolve, but a work item's own number |
| 73 | is the one to keep from now on. |