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