| 270 | 270 | | | Owner | Everything a member can, and manage members, the base permission, the workspace's access tokens, its details, and billing: the plan, card checks, prepayment and limits. Admin on every repository, and the only ones who can transfer and delete them; see [access and roles](/guides/access-and-roles/). | |
| 271 | 271 | | |
| 272 | 272 | | Whoever creates a workspace is its owner. An owner adds people on the |
| 273 | | − | workspace's **Members** (in the sidebar), `g1t.sh/<workspace>/-/people`: |
| 273 | + | workspace's **People**, `g1t.sh/<workspace>/-/people` (a tab of the |
| 274 | + | workspace's page, and in the sidebar): |
| 274 | 275 | | |
| 275 | 276 | | - **By username**: someone already on g1t joins at once, as a member. |
| 276 | 277 | | - **By email address**: g1t emails an invite that only that address can |
| ⋯ |
| 294 | 295 | | To give someone a role on one repository without making them a member, |
| 295 | 296 | | add them as an [outside collaborator](/guides/access-and-roles/#outside-collaborators). |
| 296 | 297 | | |
| 297 | | − | ## The workspace's pages |
| 298 | + | ## The workspace's page |
| 299 | + | |
| 300 | + | A workspace's own page, `g1t.sh/<workspace>`, has its icon, name, address |
| 301 | + | and description at the top, and tabs under them: |
| 298 | 302 | | |
| 299 | | − | A workspace's page, `g1t.sh/<workspace>`, shows its repositories and the |
| 300 | | − | pull requests in progress across them. Each person sees the repositories |
| 301 | | − | they can read: a member whose base permission is None, an |
| 302 | | − | [outside collaborator](/guides/access-and-roles/#outside-collaborators) |
| 303 | + | | Tab | Address | Who | | |
| 304 | + | | --- | --- | --- | --- | |
| 305 | + | | **Overview** | `g1t.sh/<workspace>` | Everyone | Your [pinned projects](#pinned-and-recent-projects), then the most active ones, the pull requests in progress across them, and **All projects**. Members also see a **Usage** card with this month's spend, and who belongs. | |
| 306 | + | | **Projects** | `/-/projects` | Everyone | Every project you can see, with their count. See [the Projects tab](#the-projects-tab). | |
| 307 | + | | [**Packages**](/guides/packages/) | `/-/packages` | Everyone | What the workspace publishes. | |
| 308 | + | | **Teams** | `/-/teams` | Members | Coming soon: groups of members given roles together. | |
| 309 | + | | **People** | `/-/people` | Members | Who belongs, with their count. Owners add and remove people here. | |
| 310 | + | | **Insights** | `/-/insights` | Members | Coming soon: how the whole workspace delivers. | |
| 311 | + | | **Settings** | `/-/settings` | Owners | How the workspace is set up and connected (below). | |
| 312 | + | |
| 313 | + | Each person sees the projects they can read: a member whose base permission |
| 314 | + | is None, an [outside collaborator](/guides/access-and-roles/#outside-collaborators) |
| 303 | 315 | | or a visitor sees the public ones and those shared with them, without the |
| 304 | | − | workspace's members, deployments or settings. Its members also see a |
| 305 | | − | **Usage** card there with this month's spend. |
| 316 | + | workspace's people, deployments or settings. |
| 317 | + | |
| 318 | + | Older addresses still work: `/-/members` opens People, and |
| 319 | + | `g1t.sh/<workspace>?tab=projects` (or `repositories`, `packages`, |
| 320 | + | `people`) opens that tab. |
| 321 | + | |
| 322 | + | ### The Projects tab |
| 323 | + | |
| 324 | + | The Projects tab is made for workspaces with hundreds of projects: |
| 306 | 325 | | |
| 307 | | − | The sidebar is one list, in groups: **Mission control**, the workspace's |
| 308 | | − | **Overview** and **Explore**; its projects; the places work happens across |
| 309 | | − | them (**Agent fleet**, **Context**, **Memory**, **Security** and |
| 310 | | − | [**Packages**](/guides/packages/)); then who belongs (**Members**, and |
| 311 | | − | **Teams** soon), **Usage**, what g1t's runs have cost (see |
| 312 | | − | [usage and billing](/guides/usage-and-billing/)), **Support** and |
| 326 | + | - **Find a project** matches every word you type in a project's name, its |
| 327 | + | address or its description. Press <kbd>/</kbd> anywhere on the page to |
| 328 | + | start typing. |
| 329 | + | - **Filters**: public or private; apps or libraries; the language its |
| 330 | + | manifests say it is written in; only projects with |
| 331 | + | [Deployments](/guides/deployments/) on; and archived projects, which are |
| 332 | + | left out unless you ask for them. Each choice shows how many projects it |
| 333 | + | holds. |
| 334 | + | - **Sort** by recently updated (its settings or its last push, whichever is |
| 335 | + | later), recently pushed, most active, or name. Most active counts each |
| 336 | + | push, issue or pull request opened or closed, review, comment and |
| 337 | + | deployment, and what happened a week ago counts half as much. |
| 338 | + | - **List** or **grid**, 30 projects to a page. |
| 339 | + | - The arrow keys (or <kbd>j</kbd> and <kbd>k</kbd>) move between projects, |
| 340 | + | and <kbd>Enter</kbd> opens one. |
| 341 | + | |
| 342 | + | Everything you choose is in the address, so a filtered list can be |
| 343 | + | bookmarked or shared. |
| 344 | + | |
| 345 | + | ## The sidebar |
| 346 | + | |
| 347 | + | The sidebar is always about one workspace: the one the switcher at its top |
| 348 | + | names. Choose the workspace's name to open its page, or the arrows beside |
| 349 | + | it to switch, or for **Workspace overview** and **All projects**. |
| 350 | + | [Explore](https://g1t.sh/explore), public projects from all of g1t, is in |
| 351 | + | the top bar, beside **Docs**. |
| 352 | + | |
| 353 | + | In order, it lists **Mission control**; the workspace's |
| 354 | + | [projects](#pinned-and-recent-projects); under **Workspace**, the places work |
| 355 | + | happens across them (**Agent fleet**, **Context**, **Memory**, **Security** |
| 356 | + | and [**Packages**](/guides/packages/), with **Boards** and **Roadmap** |
| 357 | + | soon); then **People** (and **Teams** soon), **Usage**, what g1t's runs have |
| 358 | + | cost (see [usage and billing](/guides/usage-and-billing/)), **Support** and |
| 313 | 359 | | **Settings**. An item with an arrow opens a list of its own in the sidebar: |
| 314 | 360 | | **Settings** slides over to how the workspace is set up and connected, and |
| 315 | 361 | | the row at the top, **‹ Settings**, slides back: |
| ⋯ |
| 327 | 373 | | | **Billing and plans** | Members | [The g1t plan](/guides/usage-and-billing/#the-g1t-plan), [limits](/guides/usage-and-billing/#limits) and the statement. Owners start the plan, check a card, prepay and set limits. | |
| 328 | 374 | | | **Audit log** | Members | [Every action agents, people and tokens took](/guides/audit-log/). | |
| 329 | 375 | | |
| 330 | | − | **Members** is in the main list, for every member to see; owners add and |
| 376 | + | **People** is in the main list, for every member to see; owners add and |
| 331 | 377 | | remove people there, set the |
| 332 | 378 | | [base permission](/guides/access-and-roles/#the-base-permission), and see |
| 333 | 379 | | the **Outside collaborators** tab. |
| ⋯ |
| 340 | 386 | | for the roles that can use it. A link straight to any of these pages opens |
| 341 | 387 | | the sidebar already there. |
| 342 | 388 | | |
| 389 | + | ### Pinned and recent projects |
| 390 | + | |
| 391 | + | However many projects a workspace has, its sidebar lists a few: |
| 392 | + | |
| 393 | + | - **Pinned**: the projects you pinned, in your order, up to eight a |
| 394 | + | workspace. Pin one with **Pin** on its page, or the pin on its row of the |
| 395 | + | Projects tab or its card on the Overview. Drag a pinned project to move |
| 396 | + | it, or hold <kbd>Alt</kbd> and press the up or down arrow. |
| 397 | + | - **Recent**: the projects you opened last that you have not pinned, up to |
| 398 | + | five. |
| 399 | + | - **All projects**, with how many there are, opens the Projects tab. |
| 400 | + | |
| 401 | + | Pins and recent projects are yours: nobody else sees them, and each |
| 402 | + | workspace has its own. ⌘K finds any project in the workspace, pinned or not. |
| 403 | + | From the API, use |
| 404 | + | [`GET /user/pinned_projects/{workspace}`](/reference/api/pinned-projects/list-pinned-projects/) |
| 405 | + | and the other [pinned projects](/reference/api/pinned-projects/list-pinned-projects/) |
| 406 | + | operations, or the `workspace` tool's `list_pinned_projects`, |
| 407 | + | `pin_project`, `unpin_project` and `reorder_pinned_projects` actions |
| 408 | + | over MCP. |
| 409 | + | |
| 343 | 410 | | ## Mission control |
| 344 | 411 | | |
| 345 | 412 | | Mission control, `g1t.sh` when you are signed in, is your home page. It |