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