Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 1 | --- |
| 2 | title: What is g1t? | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 3 | description: g1t is where your company's people and agents work together. Chat, a front page for the day, agents that do the work on runners, and Code and Deployments for everything they build. In alpha, with every feature marked Live, Preview or Coming. |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 4 | tableOfContents: false |
| 5 | prev: false | |
| 6 | --- | |
| 7 | ||
| 8 | import { CardGrid } from '@astrojs/starlight/components'; | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 9 | import Aside from '../../components/Aside.astro'; |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 10 | import Card from '../../components/Card.astro'; |
| 11 | import LinkCard from '../../components/LinkCard.astro'; | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 12 | import Status from '../../components/Status.astro'; |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 13 | |
| Commands that differ by system sit in tabs, one per system, and a choice holds across pages. Quickstart's token is set for bash on macOS and Linux and for PowerShell on Windows, and the self-hosted runners guide (now MDX) downloads, registers and installs the runner as a service in macOS, Linux and Windows tabs, where three blocks and a table stood one after another. Tabs are drawn like the docs' others, quiet labels over a lavender line, and a page's Markdown copy shows each tab under its label in bold. The home page opens with what its subtitle doesn't already say, and its cards carry icons (LinkCard's icon). | 14 | People and agents are members of the same workspace: they talk in channels |
| 15 | and direct messages, and they sit on the same teams. You hand an agent work, it does it | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 16 | on a runner, and it comes back with something you can act on: a pull request |
| The front page is Home: where you're needed comes first, however long ago it started, with what's at stake and how long it has waited; then what happened since you were last here, in words, with the agent work that settled, what landed, what deployed, what was decided and what was spent, switchable to the last 24 hours or 7 days; then what's running now. Your last visit is kept with your account, so it's the same on every device; Today's old address leads here. The home guide says how. | 17 | to merge, a document, a reply to approve. **Home** tells you where you are |
| 18 | needed and what happened while you were away. **Code** and **Deployments** are built in, | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 19 | because what agents make has to be reviewed, tested and shipped somewhere. |
| 20 | ||
| 21 | g1t is MIT-licensed. You can use it on g1t.sh, or run it yourself. | |
| 22 | ||
| 23 | <Aside type="note" title="g1t is in alpha"> | |
| 24 | Accounts are by invite while the alpha runs. Every feature on these pages | |
| 25 | is marked with where it stands: | |
| 26 | ||
| 27 | - <Status is="live" /> works on g1t.sh for every workspace. | |
| 28 | - <Status is="preview" /> works on g1t.sh, but is limited to some workspaces | |
| 29 | or not finished. Its page says how. | |
| 30 | - <Status is="coming" /> is planned and not built yet. Nothing on a page | |
| 31 | marked Coming works today. | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 32 | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 33 | [What g1t can't do yet](/about/limitations/) lists the limits you can hit. |
| 34 | </Aside> | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 35 | |
| 36 | <CardGrid> | |
| 37 | <LinkCard | |
| 38 | title="Quickstart" | |
| Commands that differ by system sit in tabs, one per system, and a choice holds across pages. Quickstart's token is set for bash on macOS and Linux and for PowerShell on Windows, and the self-hosted runners guide (now MDX) downloads, registers and installs the runner as a service in macOS, Linux and Windows tabs, where three blocks and a table stood one after another. Tabs are drawn like the docs' others, quiet labels over a lavender line, and a page's Markdown copy shows each tab under its label in bold. The home page opens with what its subtitle doesn't already say, and its cards carry icons (LinkCard's icon). | 39 | icon="rocket" |
| Chat and workspace agents: channels, DMs and named agents you talk to | 40 | description="Create a workspace, open Chat and talk to your first agent in a few minutes. Then put one on your code." |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 41 | href="/quickstart/" |
| 42 | /> | |
| 43 | <LinkCard | |
| Merge the workspace shell: navigation and phone shell, g1t as orchestrator, agents in roles with audience-checked reads, reactions and custom emoji, live notifications and browser push, the homepage tour (agents 0002, chat 0002) | 44 | title="Hire an agent" |
| Commands that differ by system sit in tabs, one per system, and a choice holds across pages. Quickstart's token is set for bash on macOS and Linux and for PowerShell on Windows, and the self-hosted runners guide (now MDX) downloads, registers and installs the runner as a service in macOS, Linux and Windows tabs, where three blocks and a table stood one after another. Tabs are drawn like the docs' others, quiet labels over a lavender line, and a page's Markdown copy shows each tab under its label in bold. The home page opens with what its subtitle doesn't already say, and its cards carry icons (LinkCard's icon). | 45 | icon="bot" |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 46 | description="Pick a role, give it a name, a team and a voice, and set its budget." |
| Merge the workspace shell: navigation and phone shell, g1t as orchestrator, agents in roles with audience-checked reads, reactions and custom emoji, live notifications and browser push, the homepage tour (agents 0002, chat 0002) | 47 | href="/guides/agents/#hire-an-agent" |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 48 | /> |
| 49 | <LinkCard | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 50 | title="Bring a repository" |
| Commands that differ by system sit in tabs, one per system, and a choice holds across pages. Quickstart's token is set for bash on macOS and Linux and for PowerShell on Windows, and the self-hosted runners guide (now MDX) downloads, registers and installs the runner as a service in macOS, Linux and Windows tabs, where three blocks and a table stood one after another. Tabs are drawn like the docs' others, quiet labels over a lavender line, and a page's Markdown copy shows each tab under its label in bold. The home page opens with what its subtitle doesn't already say, and its cards carry icons (LinkCard's icon). | 51 | icon="git-branch" |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 52 | description="Push any git repository, or import one from another host, and your workflows run here." |
| 53 | href="/guides/github/" | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 54 | /> |
| 55 | </CardGrid> | |
| 56 | ||
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 57 | ## The workspace |
| Chat and workspace agents: channels, DMs and named agents you talk to | 58 | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 59 | Everything happens in a workspace: your company, or one team in it. The |
| The left-hand navigation takes less room and reads at a glance. The dock becomes a rail: a 56-pixel column of icons with the g1t mark on top, the current app marked by a filled square, hover hints naming each with its shortcut, the apps you pinned in a scrolling band, and Apps, People, Workspace and your account at the foot. Each mode's sidebar sits flush against it, 240 pixels wide, opening on Search or jump to and listing its groups under small labels in 36-pixel rows; Ctrl B hides it and the page grows into the room. Every mode's list is built on the shadcn Sidebar now in the kit, so Workspace, Code, People, Notifications, account settings, Chat, Artifacts and Agents all share one frame; the phone keeps its bottom bar and drawer. The workspaces guide describes the rail, the sidebar and the page. | 60 | rail down the left holds Home, Chat, Notifications, Agents, Code and |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 61 | Artifacts, the apps you pin, and People, Workspace and your account at its |
| 62 | foot. On a phone it is a bar along the bottom. | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 63 | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 64 | | Feature | What it does | Status | |
| 65 | | --- | --- | --- | | |
| The front page is Home: where you're needed comes first, however long ago it started, with what's at stake and how long it has waited; then what happened since you were last here, in words, with the agent work that settled, what landed, what deployed, what was decided and what was spent, switchable to the last 24 hours or 7 days; then what's running now. Your last visit is kept with your account, so it's the same on every device; Today's old address leads here. The home guide says how. | 66 | | [Home](/guides/home/) | The front page: where you're needed now, what happened since you were last here, what is running, and where to start. | <Status is="preview" /> | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 67 | | [Chat](/guides/chat/) | Channels, direct messages and threads, live. People and agents are members alike. No seats and no history limit. | <Status is="live" /> | |
| 68 | | [Notifications](/guides/notifications/) | Everything waiting on you: mentions, reviews, approvals and alerts, with browser push. | <Status is="live" /> | | |
| People lists people. The directory, its counts and its search cover the workspace's people only; agents keep their page under Agents, where the Profile tab now also says what each agent is told about its teams, and the old address of an agent under People sends you there. Agents still join teams beside people: a team's members page groups them under its people with an agent badge, and the org chart shows them as members of the team beside its lead. The people and teams, agents, teams and workspaces guides say so. | 69 | | [People and teams](/guides/people-and-teams/) | Everyone in the workspace in one search, with profiles, reporting lines, an org chart and teams that include agents beside people. Members, roles, nested teams and invites. | <Status is="live" /> | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 70 | | [Artifacts](/guides/artifacts/) | Documents written together, live, by people and agents. Private until you share them. | <Status is="live" /> | |
| 71 | | More kinds of artifact | Slides, designs and dashboards that keep the query behind every number. | <Status is="coming" /> | | |
| 72 | | Scratchpads | Tools, reports and agents anyone can build on a copy of the data, used in production only after review. | <Status is="coming" /> | | |
| The phone app with your own g1t, on g1t.sh/download until Google Play, and Node 24 (#5) | 73 | | [The desktop app](/guides/desktop/) | g1t in a window of its own for Windows, macOS and Linux, with notifications from your system. | <Status is="preview" /> | |
| 74 | | [The phone app](/guides/mobile/) | Chat with your team and its agents, live, with notifications on the phone; review pull requests. Android first, for g1t.sh or your own g1t; not in the stores yet. | <Status is="preview" /> | | |
| Merge the desktop app's sandbox: its default runner now starts g1t-runner's sandbox on Windows, macOS and Linux, and says per kind of job (Linux, Windows) what it is doing or why it cannot and how to fix it. | 75 | | [A runner in the desktop app](/guides/desktop/#the-runner) | Your workspace's self-hosted jobs on your computer while g1t is open, registered and kept up to date by the app, sandboxed by default: Linux jobs in a sandbox of the runner's own on Windows, macOS and Linux, and Windows jobs in Windows Sandbox on Windows 11 Pro and up. | <Status is="preview" /> | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 76 | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 77 | ## Agents |
| 78 | ||
| 79 | | Feature | What it does | Status | | |
| 80 | | --- | --- | --- | | |
| 81 | | [Agents](/guides/agents/) | Colleagues hired into a role, each with responsibilities, a voice, the models it may use and a budget. DM one, or mention it in a thread. | <Status is="live" /> | | |
| 82 | | [g1t, the orchestrator](/guides/agents/) | Every workspace's own agent. It knows the others, answers or brings in the right one, and keeps you in the conversation. | <Status is="live" /> | | |
| 83 | | [Model providers](/guides/models/) | Agents use your own provider's key, or g1t's hosted models through the [AI Gateway](/guides/ai-gateway/). | <Status is="live" /> | | |
| 84 | | g1t's hosted models | Models g1t runs for you, billed on your workspace. Open to invited workspaces during the alpha; everyone else connects a provider. | <Status is="preview" /> | | |
| The Spend page says what a workspace spent, where it went and the budgets that hold it, in Workspace under Money: spent at price, agents' spend and the spend limit; by day; by agent, person, channel, model, kind of work and product; budgets from the workspace down to each person, agent and task, with what happens at 100%; the costliest tasks, each with a receipt of every session at the provider's price and what was charged; and how it's priced. Everyone sees what agents spent for them, and owners and billing managers the whole workspace; each person can have a monthly budget agents keep to, and the spend pill in the top bar shows your month or the workspace's against its limit. The spend guide says how. | 85 | | [Budgets](/guides/agent-budgets/) and [guardrails](/guides/guardrails/) | Spend limits per workspace, person, agent and task, checked before work starts, and what an agent may do alone. | <Status is="live" /> | |
| 86 | | [Spend](/guides/spend/) | Where the money went, by agent, person, channel, model and product; every budget with what happens at 100%; a receipt for each task; your own spend in the top bar. | <Status is="preview" /> | | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 87 | | [Acting for the asker](/guides/agent-access/) | Agents act with the access of the person who asked, and answer with only what their audience may see. | <Status is="live" /> | |
| 88 | | [Memory](/guides/agent-memory/), [sessions](/guides/agent-sessions/) and [routines](/guides/agent-routines/) | What an agent keeps, every run with its steps and cost, and work on a schedule. | <Status is="live" /> | | |
| The Marketplace adds what g1t doesn't do and connects what you already use: extensions (Mail, Support, CRM, Recruiting, On-call, and bridges to a helpdesk, CRM or ERP you run, all Soon), starter kits, and integrations connected by the workspace or by each person; agents aren't installed there. Agent templates live in Agents, as starting points you configure, at Agents → Templates, and the Marketplace's old agent addresses lead there. The marketplace and agents guides say how. | 89 | | [Agent templates](/guides/agents/#role-templates) | Starting points for a new agent in Agents, each with responsibilities, a voice and the helpers it works with, configured once you start one. | <Status is="live" /> | |
| Merge remote-tracking branch 'origin/claude/cool-newton-7nm8r9' into claude/cool-newton-7nm8r9 | 90 | | [Agents from plugins](/guides/customize/#plugins) | Subagents a plugin brings, listed under Templates → From plugins and hired like any template. | <Status is="live" /> | |
| Every agent starts with g1t's foundational skills, playbooks for documents, research, data, code, communication, and files and media, each using only tools the agent already has and saying plainly what isn't possible yet: agents make PDFs, Word documents, spreadsheets, CSV and Markdown files with make_file, kept with a doc in Artifacts and served from g1tusercontent.com; an agent's Skills tab shows what each skill can do and with which tools, and owners turn a skill off per agent; the agent skills guide says how. | 91 | | [Foundational skills](/guides/agent-skills/) | Every agent makes PDFs, Word documents and spreadsheets, writes reports with sources, charts data, reviews code and summarizes threads, with the tools it already has. Owners turn skills off per agent. | <Status is="live" /> | |
| Merge remote-tracking branch 'origin/claude/cool-newton-7nm8r9' into claude/cool-newton-7nm8r9 | 92 | | [Skill library](/guides/agent-skills/#the-skill-library) | Your own skills in the open SKILL.md format: written in g1t, imported from a file or a repository, or saved from a finished session; attached to agents, teams or every agent at a pinned version, optionally kept in `.claude/skills/` in a repository. | <Status is="live" /> | |
| 93 | | [Plugin skills](/guides/customize/#skills) | Every skill published in a marketplace, added to the library in a click as `plugin:skill` and made available to every agent, a team or one. | <Status is="live" /> | | |
| 94 | | Web research, skill scripts | Research on the open web, set per team; scripts run on an agent's own computer. | <Status is="coming" /> | | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 95 | | Agents on runners | Every agent's machine is a runner: g1t's, one of yours, or your desktop, with sessions that last between tasks. | <Status is="coming" /> | |
| 96 | | [Agents in your chat app](/guides/chat-app/) | The same agents, answering in the chat app your team already uses. | <Status is="coming" /> | | |
| 97 | ||
| 98 | ## Code and Deployments | |
| 99 | ||
| 100 | | Feature | What it does | Status | | |
| 101 | | --- | --- | --- | | |
| 102 | | [Repositories](/guides/managing-repositories/) and [git](/guides/git/) | Public and private repositories over HTTPS, with creating one by pushing to it. | <Status is="live" /> | | |
| 103 | | [Issues and pull requests](/guides/pull-requests/) | Issues, pull requests, line comments and reviews from people and agents. | <Status is="live" /> | | |
| 104 | | [Checks](/guides/checks/), [rules](/guides/rules/) and the [merge queue](/guides/merge-queue/) | Required checks, protected branches, code owners, and changes tested together before they land. | <Status is="live" /> | | |
| 105 | | [Workflows](/guides/actions/) | Workflows from `.g1t/workflows`, most unchanged, on g1t's runners or [your own](/guides/self-hosted-runners/). | <Status is="live" /> | | |
| 106 | | [g1t's agent on an issue](/guides/working-with-g1t/) | Assign an issue to g1t: it opens a pull request, runs your checks, gets a review and revises until they pass. Open to invited workspaces during the alpha. | <Status is="preview" /> | | |
| 107 | | [Bring your own agent](/guides/bring-your-own-agent/) | Any coding agent or MCP client works on g1t and records its session onto its pull requests. | <Status is="live" /> | | |
| 108 | | [Packages](/guides/packages/) | npm, Cargo, Composer, Maven, NuGet, RubyGems, Go modules and container images. | <Status is="live" /> | | |
| 109 | | [Security](/guides/security/) | Secret push protection, history scanning and pull requests that upgrade vulnerable dependencies. | <Status is="live" /> | | |
| 110 | | [Deployments](/guides/deployments/) | A live preview of every pull request on g1t.page, production on merge, and custom domains. | <Status is="live" /> | | |
| 111 | | Preview data | Each preview gets its own copy of the database and bucket, deleted when the pull request closes. | <Status is="coming" /> | | |
| Merge GitHub pull request #8 (claude/cool-newton-7nm8r9): Docker deployments on g1t.page behind a switch that stays off until Cloudflare's container APIs are checked live, workflows a workspace manages in its repositories, tarball and zipball downloads, refs/pull/* kept to g1t alone, framework detection for g1t.page builds, and a workflow's event payload matching GitHub's. | 112 | | [Docker deployments](/guides/deployments/#docker-deployments) | Any app with a Dockerfile, or a Node.js, Python, Go, Ruby or PHP server, runs as a container that sleeps when no one visits. | <Status is="coming" /> | |
| Projects have Observability: their requests, logs, traces, metrics and errors, from apps on g1t.page with nothing to set up, and from software anywhere else over OpenTelemetry. | 113 | | [Observability](/guides/observability/) | Requests, logs, traces, metrics and grouped errors, by deployment: from apps on g1t.page with nothing to set up, and from anywhere else over OpenTelemetry. | <Status is="live" /> | |
| 114 | | Rollback and always on | One click back to any deploy, and container apps kept warm. | <Status is="coming" /> | | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 115 | | [GitHub](/guides/github/) and [mirroring](/guides/mirroring/) | Import repositories, keep them mirrored, or push changes back. | <Status is="live" /> | |
| 116 | | Git over SSH | `git@g1t.sh` remotes. Use HTTPS until then. | <Status is="coming" /> | | |
| 117 | ||
| 118 | ## Extend and connect | |
| 119 | ||
| 120 | | Feature | What it does | Status | | |
| 121 | | --- | --- | --- | | |
| 122 | | [Integrations](/guides/integrations/) | The GitHub App, Sentry, Datadog, Jira, Linear and alerts. | <Status is="live" /> | | |
| 123 | | [API](/reference/api/), [MCP](/reference/mcp/) and [webhooks](/guides/webhooks/) | Everything as a REST endpoint and an MCP tool, and a webhook for every event. | <Status is="live" /> | | |
| Merge remote-tracking branch 'origin/claude/cool-newton-7nm8r9' into claude/cool-newton-7nm8r9 | 124 | | [Customize](/guides/customize/) | Skills, Connectors and Plugins, each with Yours and Discover: marketplaces, plugins, skills, subagents and MCP servers in the formats Claude Code reads, added by owners; members ask for what they need. | <Status is="live" /> | |
| 125 | | [Connectors](/guides/customize/#connectors) | Remote MCP servers from the directory, a plugin or an address, signed in once with the browser or a key and given to every agent, a team or one, with a level per tool. | <Status is="live" /> | | |
| 126 | | g1t's own plugins | Mail, Support, CRM, Recruiting, On-call and bridges to a helpdesk, CRM or ERP, listed in the `g1t` marketplace and installable from their first release. | <Status is="coming" /> | | |
| g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them. | 127 | | More integrations | Drive, Gmail, Calendar, Slack and Microsoft 365, each listing what it lets agents do. | <Status is="coming" /> | |
| 128 | | Mail | Email on your own domain, with shared inboxes that agents work in. | <Status is="coming" /> | | |
| 129 | ||
| 130 | ## Your workspace | |
| 131 | ||
| 132 | | Feature | What it does | Status | | |
| 133 | | --- | --- | --- | | |
| 134 | | [Accounts and sign-in](/guides/authentication/) | Invites, two-factor authentication, access tokens and OAuth apps. | <Status is="live" /> | | |
| 135 | | Single sign-on | SAML or OIDC and SCIM, set up by each workspace for itself. | <Status is="coming" /> | | |
| 136 | | [Usage and billing](/guides/usage-and-billing/) | No seats. Usage at what it costs, a spend limit, and itemised invoices. | <Status is="live" /> | | |
| 137 | | Storage | Databases and buckets your teams can create, at a level each team is given, with copies of production data for anything not yet reviewed. | <Status is="coming" /> | | |
| 138 | | [Audit log](/guides/audit-log/) | Every change to the workspace, with export. | <Status is="live" /> | | |
| 139 | | [Run g1t yourself](/guides/self-hosting/) | The core forge in Docker. Agents, deployments and context search are off in this version. | <Status is="preview" /> | | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 140 | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 141 | ## Bring a repository |
| 142 | ||
| 143 | <CardGrid> | |
| 144 | <LinkCard | |
| 145 | title="Push any repository" | |
| 146 | description="Push any git repository, rename .github to .g1t, and your workflows run here, most without changes." | |
| 147 | href="/guides/actions/" | |
| 148 | /> | |
| 149 | <LinkCard | |
| 150 | title="Import from another host" | |
| 151 | description="Sign in with your existing git host, then import, mirror or move your repositories, private ones too." | |
| 152 | href="/guides/github/" | |
| 153 | /> | |
| 154 | </CardGrid> | |
| 155 | ||
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 156 | ## Look after a repository |
| 157 | ||
| 158 | <CardGrid> | |
| 159 | <LinkCard | |
| 160 | title="Managing a repository" | |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 161 | description="See its languages, contributors, license and stars, rename it or a branch, change its default branch, make it public or private, archive it, and delete and restore it." |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 162 | href="/guides/managing-repositories/" |
| 163 | /> | |
| 164 | <LinkCard | |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 165 | title="Releases" |
| 166 | description="Publish a tag with a title and notes, keep drafts and pre-releases, and read the latest release from the API." | |
| 167 | href="/guides/releases/" | |
| 168 | /> | |
| 169 | <LinkCard | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 170 | title="Required checks" |
| 171 | description="Choose which workflow checks must pass before anything merges into the default branch, or add CI to a repository that has none." | |
| 172 | href="/guides/pull-requests/#required-status-checks" | |
| 173 | /> | |
| 174 | <LinkCard | |
| Merge checks: statuses and check runs on every commit | 175 | title="Checks" |
| 176 | description="See what CI, workflows and integrations say beside every commit, and report statuses and check runs with annotations from your own tools." | |
| 177 | href="/guides/checks/" | |
| 178 | /> | |
| 179 | <LinkCard | |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 180 | title="Labels and milestones" |
| 181 | description="Say what issues and pull requests are with colored labels, and gather them under milestones with due dates." | |
| 182 | href="/guides/labels/" | |
| 183 | /> | |
| 184 | <LinkCard | |
| 185 | title="Pull requests into other branches" | |
| 186 | description="Open a pull request into a release or feature branch, and change the branch one merges into." | |
| 187 | href="/guides/base-branches/" | |
| 188 | /> | |
| 189 | <LinkCard | |
| 190 | title="Dependency updates" | |
| 191 | description="Keep npm, Cargo, Go and pip dependencies current with a dependabot.yml file, on the schedule you set." | |
| 192 | href="/guides/dependency-updates/" | |
| 193 | /> | |
| 194 | <LinkCard | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 195 | title="Access and roles" |
| 196 | description="Give people a role on a repository, invite outside collaborators, and set what every member gets." | |
| 197 | href="/guides/access-and-roles/" | |
| 198 | /> | |
| 199 | <LinkCard | |
| Merge branch 'worktree-agent-a5a5de74d8863d554' into worktree-agent-a16631325aecf58ca | 200 | title="Deploy keys" |
| 201 | description="Let a server or a pipeline clone one repository, or push to it, with an SSH key that reaches nothing else." | |
| 202 | href="/guides/git/#deploy-keys" | |
| 203 | /> | |
| 204 | <LinkCard | |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 205 | title="Teams" |
| People and teams are front and centre: one directory of people and agents with presence, local time, titles, teams and what each owns; profiles with manager and reports and the agents they work with; an org chart with each team's agents beside the person who leads it; and teams of any mix, with a lead, a channel, a budget agents keep to and the agents on them. Every agent is told its teams each turn (who leads, who owns what, who's around and who to page), and the team page shows exactly what. Member management is Members and invites; the people and teams guide says how. | 206 | description="Group people and agents into teams, give a team a role on repositories, mention it, and have it pick who reviews." |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 207 | href="/guides/teams/" |
| 208 | /> | |
| 209 | <LinkCard | |
| People and teams are front and centre: one directory of people and agents with presence, local time, titles, teams and what each owns; profiles with manager and reports and the agents they work with; an org chart with each team's agents beside the person who leads it; and teams of any mix, with a lead, a channel, a budget agents keep to and the agents on them. Every agent is told its teams each turn (who leads, who owns what, who's around and who to page), and the team page shows exactly what. Member management is Members and invites; the people and teams guide says how. | 210 | title="People and teams" |
| 211 | description="Find anyone, person or agent, see what they own and who they report to, and read what agents are told about their teams." | |
| 212 | href="/guides/people-and-teams/" | |
| 213 | /> | |
| 214 | <LinkCard | |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 215 | title="Report deployments" |
| 216 | description="See every deployment and environment in one place, report deployments from any CI, and require one before a merge." | |
| 217 | href="/guides/deployments-api/" | |
| 218 | /> | |
| 219 | <LinkCard | |
| Merge rulesets: branch and tag rules, agent-first, enforced on push and merge | 220 | title="Rules" |
| 221 | description="Protect branches and tags with rulesets: pull requests, checks, signed commits, merge windows, and rules for agents' changes." | |
| 222 | href="/guides/rules/" | |
| 223 | /> | |
| 224 | <LinkCard | |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 225 | title="CODEOWNERS" |
| 226 | description="Say who owns which paths, ask them to review the changes to their files, and require their approval before a merge." | |
| 227 | href="/guides/codeowners/" | |
| 228 | /> | |
| 229 | <LinkCard | |
| Audit logs are kept by plan: a week on free, 90 days on the plan, and what staff set for an account in sudo | 230 | title="Transferring a repository" |
| 231 | description="Move a repository to another workspace you own, while its old address keeps working." | |
| 232 | href="/guides/transferring-repositories/" | |
| 233 | /> | |
| 234 | </CardGrid> | |
| 235 | ||
| 236 | ## Know the limits | |
| 237 | ||
| 238 | [What g1t can't do yet](/about/limitations/) lists every limit you can | |
| 239 | hit today, why it exists, what to do instead, and whether it is planned. | |
| 240 | ||
| 241 | ## Using an AI assistant? | |
| 242 | ||
| 243 | Give it [g1t.sh/llms.txt](https://g1t.sh/llms.txt), which describes g1t for | |
| 244 | agents, and ask it to set you up. Every page here also has **Copy page** at | |
| 245 | the top, to paste into a conversation, and a plain Markdown version at its | |
| 246 | address plus `.md`. |
This file's history is long; its oldest lines are credited to the oldest commit read.