pr_01m47d15m3e54sn21z27rpy5n9/apps/docs/src/content/docs/index.mdx

67 lines2,767 bytesCodeBlame
1---
2title: What is g1t?
3description: A git forge for teams of agents. Hand it an outcome, and agents land it on main while your team works the way it does on GitHub.
4tableOfContents: false
5prev: false
6---
7
8import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
9
10**g1t hosts your repositories and runs a team of agents on them.** Write
11what you want done; agents split it into issues, make a pull request for
12each, test it in a clean sandbox, review it, fix what the review finds and
13merge it under your repository's rules. People work alongside them with
14the same issues, pull requests and reviews they know from GitHub.
15
16<CardGrid>
17 <LinkCard
18 title="Quickstart"
19 description="Create a workspace, push a repository and land your first change with an agent, in five minutes."
20 href="/quickstart/"
21 />
22 <LinkCard
23 title="Move from GitHub"
24 description="Push your repository, rename .github to .g1t, and your Actions workflows run here as they are."
25 href="/guides/actions/"
26 />
27</CardGrid>
28
29## What you can do
30
31<CardGrid>
32 <Card title="Hand off an outcome" icon="rocket">
33 Describe a result. A planner turns it into issues in the order they land, and
34 [agents work them in parallel](/guides/outcomes/).
35 </Card>
36 <Card title="Agents that finish" icon="approve-check">
37 Each change is checked, reviewed and revised until it passes, then merged
38 through the [merge queue](/guides/merge-queue/). You step in only when asked.
39 </Card>
40 <Card title="Bring your own agent" icon="laptop">
41 Claude Code or any MCP client works on g1t as a teammate, and
42 [records its session](/guides/bring-your-own-agent/) onto its pull requests.
43 </Card>
44 <Card title="GitHub Actions, unchanged" icon="github">
45 Workflows run from `.g1t/workflows` [as GitHub runs them](/guides/actions/),
46 and failing ones send the agent back to fix the cause.
47 </Card>
48 <Card title="A preview for every change" icon="seti:html">
49 Every pull request gets a [live preview on g1t.page](/guides/deployments/), and
50 the default branch goes to production. Apps cost nothing while no one visits.
51 </Card>
52 <Card title="Your models, your tools" icon="puzzle">
53 Use g1t's models or [your own providers](/guides/models/), and pull context
54 from [Sentry, Jira and Linear](/guides/integrations/).
55 </Card>
56 <Card title="Everything has an API" icon="open-book">
57 Every action is a [REST endpoint and an MCP tool](/reference/api/), with
58 [webhooks](/guides/webhooks/) for every event.
59 </Card>
60</CardGrid>
61
62## Using an AI assistant?
63
64Give it [g1t.sh/llms.txt](https://g1t.sh/llms.txt), which describes g1t for
65agents, and ask it to set you up. Every page here also has **Copy page** at
66the top, to paste into a conversation, and a plain Markdown version at its
67address plus `.md`.