| 1 | --- |
| 2 | title: What is g1t? |
| 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. |
| 4 | tableOfContents: false |
| 5 | prev: false |
| 6 | --- |
| 7 | |
| 8 | import { CardGrid } from '@astrojs/starlight/components'; |
| 9 | import Aside from '../../components/Aside.astro'; |
| 10 | import Card from '../../components/Card.astro'; |
| 11 | import LinkCard from '../../components/LinkCard.astro'; |
| 12 | import Status from '../../components/Status.astro'; |
| 13 | |
| 14 | **g1t is where your company's people and agents work together.** People and |
| 15 | agents are members of the same workspace: they talk in channels and direct |
| 16 | messages, and they sit on the same teams. You hand an agent work, it does it |
| 17 | on a runner, and it comes back with something you can act on: a pull request |
| 18 | to merge, a document, a reply to approve. **Home** tells you where you are |
| 19 | needed and what happened while you were away. **Code** and **Deployments** are built in, |
| 20 | because what agents make has to be reviewed, tested and shipped somewhere. |
| 21 | |
| 22 | g1t is MIT-licensed. You can use it on g1t.sh, or run it yourself. |
| 23 | |
| 24 | <Aside type="note" title="g1t is in alpha"> |
| 25 | Accounts are by invite while the alpha runs. Every feature on these pages |
| 26 | is marked with where it stands: |
| 27 | |
| 28 | - <Status is="live" /> works on g1t.sh for every workspace. |
| 29 | - <Status is="preview" /> works on g1t.sh, but is limited to some workspaces |
| 30 | or not finished. Its page says how. |
| 31 | - <Status is="coming" /> is planned and not built yet. Nothing on a page |
| 32 | marked Coming works today. |
| 33 | |
| 34 | [What g1t can't do yet](/about/limitations/) lists the limits you can hit. |
| 35 | </Aside> |
| 36 | |
| 37 | <CardGrid> |
| 38 | <LinkCard |
| 39 | title="Quickstart" |
| 40 | description="Create a workspace, open Chat and talk to your first agent in a few minutes. Then put one on your code." |
| 41 | href="/quickstart/" |
| 42 | /> |
| 43 | <LinkCard |
| 44 | title="Hire an agent" |
| 45 | description="Pick a role, give it a name, a team and a voice, and set its budget." |
| 46 | href="/guides/agents/#hire-an-agent" |
| 47 | /> |
| 48 | <LinkCard |
| 49 | title="Bring a repository" |
| 50 | description="Push any git repository, or import one from another host, and your workflows run here." |
| 51 | href="/guides/github/" |
| 52 | /> |
| 53 | </CardGrid> |
| 54 | |
| 55 | ## The workspace |
| 56 | |
| 57 | Everything happens in a workspace: your company, or one team in it. The |
| 58 | rail down the left holds Home, Chat, Notifications, Agents, Code and |
| 59 | Artifacts, the apps you pin, and People, Workspace and your account at its |
| 60 | foot. On a phone it is a bar along the bottom. |
| 61 | |
| 62 | | Feature | What it does | Status | |
| 63 | | --- | --- | --- | |
| 64 | | [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" /> | |
| 65 | | [Chat](/guides/chat/) | Channels, direct messages and threads, live. People and agents are members alike. No seats and no history limit. | <Status is="live" /> | |
| 66 | | [Notifications](/guides/notifications/) | Everything waiting on you: mentions, reviews, approvals and alerts, with browser push. | <Status is="live" /> | |
| 67 | | [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" /> | |
| 68 | | [Artifacts](/guides/artifacts/) | Documents written together, live, by people and agents. Private until you share them. | <Status is="live" /> | |
| 69 | | More kinds of artifact | Slides, designs and dashboards that keep the query behind every number. | <Status is="coming" /> | |
| 70 | | Scratchpads | Tools, reports and agents anyone can build on a copy of the data, used in production only after review. | <Status is="coming" /> | |
| 71 | | [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" /> | |
| 72 | | [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" /> | |
| 73 | | A runner inside the desktop app | Agents working on your own machine, with what only it reaches. | <Status is="coming" /> | |
| 74 | |
| 75 | ## Agents |
| 76 | |
| 77 | | Feature | What it does | Status | |
| 78 | | --- | --- | --- | |
| 79 | | [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" /> | |
| 80 | | [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" /> | |
| 81 | | [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" /> | |
| 82 | | 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" /> | |
| 83 | | [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" /> | |
| 84 | | [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" /> | |
| 85 | | [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" /> | |
| 86 | | [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" /> | |
| 87 | | [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" /> | |
| 88 | | More specialists | Templates that bring their own skills, tools and the runner they prefer. | <Status is="coming" /> | |
| 89 | | [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" /> | |
| 90 | | [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 `.g1t/skills/` in a repository. | <Status is="live" /> | |
| 91 | | Web research, Marketplace skills, skill scripts | Research on the open web, set per team; skills that extensions bring; scripts run on an agent's own computer. | <Status is="coming" /> | |
| 92 | | 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" /> | |
| 93 | | [Agents in your chat app](/guides/chat-app/) | The same agents, answering in the chat app your team already uses. | <Status is="coming" /> | |
| 94 | |
| 95 | ## Code and Deployments |
| 96 | |
| 97 | | Feature | What it does | Status | |
| 98 | | --- | --- | --- | |
| 99 | | [Repositories](/guides/managing-repositories/) and [git](/guides/git/) | Public and private repositories over HTTPS, with creating one by pushing to it. | <Status is="live" /> | |
| 100 | | [Issues and pull requests](/guides/pull-requests/) | Issues, pull requests, line comments and reviews from people and agents. | <Status is="live" /> | |
| 101 | | [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" /> | |
| 102 | | [Workflows](/guides/actions/) | Workflows from `.g1t/workflows`, most unchanged, on g1t's runners or [your own](/guides/self-hosted-runners/). | <Status is="live" /> | |
| 103 | | [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" /> | |
| 104 | | [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" /> | |
| 105 | | [Packages](/guides/packages/) | npm, Cargo, Composer, Maven, NuGet, RubyGems, Go modules and container images. | <Status is="live" /> | |
| 106 | | [Security](/guides/security/) | Secret push protection, history scanning and pull requests that upgrade vulnerable dependencies. | <Status is="live" /> | |
| 107 | | [Deployments](/guides/deployments/) | A live preview of every pull request on g1t.page, production on merge, and custom domains. | <Status is="live" /> | |
| 108 | | Preview data | Each preview gets its own copy of the database and bucket, deleted when the pull request closes. | <Status is="coming" /> | |
| 109 | | Rollback and always on | One click back to any deploy, request logs, and container apps kept warm. | <Status is="coming" /> | |
| 110 | | [GitHub](/guides/github/) and [mirroring](/guides/mirroring/) | Import repositories, keep them mirrored, or push changes back. | <Status is="live" /> | |
| 111 | | Git over SSH | `git@g1t.sh` remotes. Use HTTPS until then. | <Status is="coming" /> | |
| 112 | |
| 113 | ## Extend and connect |
| 114 | |
| 115 | | Feature | What it does | Status | |
| 116 | | --- | --- | --- | |
| 117 | | [Integrations](/guides/integrations/) | The GitHub App, Sentry, Datadog, Jira, Linear and alerts. | <Status is="live" /> | |
| 118 | | [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" /> | |
| 119 | | [Marketplace](/guides/marketplace/) | Extensions that add functionality, and integrations that connect your data for agents, added by owners; members ask for what they need. | <Status is="live" /> | |
| 120 | | Extensions | Pages, cards, tools and agent roles shared from public repositories, installed by an owner after reading their permissions and where their data goes. Mail, Support, CRM, Recruiting, On-call and bridges to a helpdesk, CRM or ERP are listed. | <Status is="coming" /> | |
| 121 | | More integrations | Drive, Gmail, Calendar, Slack and Microsoft 365, each listing what it lets agents do. | <Status is="coming" /> | |
| 122 | | Mail | Email on your own domain, with shared inboxes that agents work in. | <Status is="coming" /> | |
| 123 | |
| 124 | ## Your workspace |
| 125 | |
| 126 | | Feature | What it does | Status | |
| 127 | | --- | --- | --- | |
| 128 | | [Accounts and sign-in](/guides/authentication/) | Invites, two-factor authentication, access tokens and OAuth apps. | <Status is="live" /> | |
| 129 | | Single sign-on | SAML or OIDC and SCIM, set up by each workspace for itself. | <Status is="coming" /> | |
| 130 | | [Usage and billing](/guides/usage-and-billing/) | No seats. Usage at what it costs, a spend limit, and itemised invoices. | <Status is="live" /> | |
| 131 | | 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" /> | |
| 132 | | [Audit log](/guides/audit-log/) | Every change to the workspace, with export. | <Status is="live" /> | |
| 133 | | [Run g1t yourself](/guides/self-hosting/) | The core forge in Docker. Agents, deployments and context search are off in this version. | <Status is="preview" /> | |
| 134 | |
| 135 | ## Bring a repository |
| 136 | |
| 137 | <CardGrid> |
| 138 | <LinkCard |
| 139 | title="Push any repository" |
| 140 | description="Push any git repository, rename .github to .g1t, and your workflows run here, most without changes." |
| 141 | href="/guides/actions/" |
| 142 | /> |
| 143 | <LinkCard |
| 144 | title="Import from another host" |
| 145 | description="Sign in with your existing git host, then import, mirror or move your repositories, private ones too." |
| 146 | href="/guides/github/" |
| 147 | /> |
| 148 | </CardGrid> |
| 149 | |
| 150 | ## Look after a repository |
| 151 | |
| 152 | <CardGrid> |
| 153 | <LinkCard |
| 154 | title="Managing a repository" |
| 155 | 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." |
| 156 | href="/guides/managing-repositories/" |
| 157 | /> |
| 158 | <LinkCard |
| 159 | title="Releases" |
| 160 | description="Publish a tag with a title and notes, keep drafts and pre-releases, and read the latest release from the API." |
| 161 | href="/guides/releases/" |
| 162 | /> |
| 163 | <LinkCard |
| 164 | title="Required checks" |
| 165 | description="Choose which workflow checks must pass before anything merges into the default branch, or add CI to a repository that has none." |
| 166 | href="/guides/pull-requests/#required-status-checks" |
| 167 | /> |
| 168 | <LinkCard |
| 169 | title="Checks" |
| 170 | description="See what CI, workflows and integrations say beside every commit, and report statuses and check runs with annotations from your own tools." |
| 171 | href="/guides/checks/" |
| 172 | /> |
| 173 | <LinkCard |
| 174 | title="Labels and milestones" |
| 175 | description="Say what issues and pull requests are with colored labels, and gather them under milestones with due dates." |
| 176 | href="/guides/labels/" |
| 177 | /> |
| 178 | <LinkCard |
| 179 | title="Pull requests into other branches" |
| 180 | description="Open a pull request into a release or feature branch, and change the branch one merges into." |
| 181 | href="/guides/base-branches/" |
| 182 | /> |
| 183 | <LinkCard |
| 184 | title="Dependency updates" |
| 185 | description="Keep npm, Cargo, Go and pip dependencies current with a dependabot.yml file, on the schedule you set." |
| 186 | href="/guides/dependency-updates/" |
| 187 | /> |
| 188 | <LinkCard |
| 189 | title="Access and roles" |
| 190 | description="Give people a role on a repository, invite outside collaborators, and set what every member gets." |
| 191 | href="/guides/access-and-roles/" |
| 192 | /> |
| 193 | <LinkCard |
| 194 | title="Deploy keys" |
| 195 | description="Let a server or a pipeline clone one repository, or push to it, with an SSH key that reaches nothing else." |
| 196 | href="/guides/git/#deploy-keys" |
| 197 | /> |
| 198 | <LinkCard |
| 199 | title="Teams" |
| 200 | description="Group people and agents into teams, give a team a role on repositories, mention it, and have it pick who reviews." |
| 201 | href="/guides/teams/" |
| 202 | /> |
| 203 | <LinkCard |
| 204 | title="People and teams" |
| 205 | description="Find anyone, person or agent, see what they own and who they report to, and read what agents are told about their teams." |
| 206 | href="/guides/people-and-teams/" |
| 207 | /> |
| 208 | <LinkCard |
| 209 | title="Report deployments" |
| 210 | description="See every deployment and environment in one place, report deployments from any CI, and require one before a merge." |
| 211 | href="/guides/deployments-api/" |
| 212 | /> |
| 213 | <LinkCard |
| 214 | title="Rules" |
| 215 | description="Protect branches and tags with rulesets: pull requests, checks, signed commits, merge windows, and rules for agents' changes." |
| 216 | href="/guides/rules/" |
| 217 | /> |
| 218 | <LinkCard |
| 219 | title="CODEOWNERS" |
| 220 | description="Say who owns which paths, ask them to review the changes to their files, and require their approval before a merge." |
| 221 | href="/guides/codeowners/" |
| 222 | /> |
| 223 | <LinkCard |
| 224 | title="Transferring a repository" |
| 225 | description="Move a repository to another workspace you own, while its old address keeps working." |
| 226 | href="/guides/transferring-repositories/" |
| 227 | /> |
| 228 | </CardGrid> |
| 229 | |
| 230 | ## Know the limits |
| 231 | |
| 232 | [What g1t can't do yet](/about/limitations/) lists every limit you can |
| 233 | hit today, why it exists, what to do instead, and whether it is planned. |
| 234 | |
| 235 | ## Using an AI assistant? |
| 236 | |
| 237 | Give it [g1t.sh/llms.txt](https://g1t.sh/llms.txt), which describes g1t for |
| 238 | agents, and ask it to set you up. Every page here also has **Copy page** at |
| 239 | the top, to paste into a conversation, and a plain Markdown version at its |
| 240 | address plus `.md`. |