Skip to content
Sign up

flagon-io/g1t

public
00

Where people and agents ship software together. The open-source git platform for the whole job: issues, agents, checks and deploys to the edge.

gitagentscloudflarerustforgemcp
146 linesCodeBlameRaw
1---
2title: Quickstart
3description: Sign up, push a repository, open an issue, and have your own coding agent open a pull request that you merge. Then bring your team into Chat.
4---
5
6import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
7import Aside from '../../components/Aside.astro';
8import AgentSetup from '../../components/AgentSetup.astro';
9
10This page takes you from sign-up to a pull request your coding agent
11opened and you merged. It takes a few minutes.
12
13<Aside type="tip" title="Let an assistant do it">
14Give your AI assistant [g1t.sh/llms.txt](https://g1t.sh/llms.txt) and ask it
15to set you up. It gives you a link to open in your browser, where you sign up
16and approve it. It never sees your password.
17</Aside>
18
19<Steps>
20
211. **Sign up**
22
23 [Sign up](https://g1t.sh/register) with an email address and a
24 password, or with GitHub. Anyone can; no invite is needed. Confirm your
25 email with the code g1t sends (or the link in the same email).
26
27 Your account comes with a **workspace** of its own, named after your
28 username. It holds your repositories and your channels. See
29 [workspaces](/guides/workspaces/).
30
312. **Install the CLI and sign in**
32
33 <Tabs syncKey="os">
34 <TabItem label="macOS and Linux">
35 ```sh
36 curl -fsSL https://g1t.sh/install | sh
37 ```
38 </TabItem>
39 <TabItem label="Windows">
40 ```powershell
41 irm https://g1t.sh/install.ps1 | iex
42 ```
43 </TabItem>
44 </Tabs>
45
46 ```sh
47 g1t auth login --git
48 ```
49
50 `g1t` shows a code and opens your browser: check the code and approve.
51 `--git` also sets git up to use the same sign-in for `g1t.sh`, so
52 `git push` asks for nothing. `g1t auth status` shows who you are signed
53 in as. See [the g1t CLI](/guides/cli/).
54
55 <Aside title="Without the CLI">
56 Git and the API also take an [access token](/guides/authentication/#access-tokens):
57 create one in [Settings → Access tokens](https://g1t.sh/settings/tokens),
58 and give it to git as the password, with your username.
59 </Aside>
60
613. **Push a repository**
62
63 From a git repository with at least one commit:
64
65 ```sh
66 g1t repo create my-project --source . --remote g1t
67 ```
68
69 This makes `<workspace>/my-project`, private, adds it as the remote
70 `g1t` and pushes. Plain git works too: pushing to a repository that does
71 not exist creates it, private.
72
73 ```sh
74 git remote add g1t https://g1t.sh/<workspace>/my-project.git
75 git push -u g1t main
76 ```
77
78 **New** in the site's header makes one empty, or imports one from
79 GitHub or any git host by its address.
80
81 <Aside title="Coming from GitHub?">
82 Rename `.github` to `.g1t` before you push, and your GitHub Actions
83 workflows run on g1t, most without changes. Workflows are compute: on a
84 free workspace, an owner checks a card once under **Settings → Billing
85 and plans** to start a $5 trial, which is never charged for the check.
86 See [GitHub Actions](/guides/actions/),
87 [No card, no compute](/guides/usage-and-billing/#no-card-no-compute) and
88 [what is not supported yet](/about/limitations/#actions-and-runners).
89 </Aside>
90
914. **Open an issue**
92
93 On the repository's **Issues** page, choose **New issue**, or:
94
95 ```sh
96 g1t issue create -t "Greeting should name the caller" -b "Take a name from the first argument."
97 ```
98
99 Say what is wrong or wanted, and what done means if you know it. Your
100 agent works from this text.
101
1025. **Connect your coding agent**
103
104 <AgentSetup />
105
106 Approve in your browser when it asks. Then ask:
107
108 > Work on issue 1 of `<workspace>/my-project` on g1t. Open a pull request
109 > for it and record your session as you go.
110
111 It opens a pull request, pushes its change, and your
112 workflows run on it as on anyone's. See
113 [Connect a coding agent](/guides/bring-your-own-agent/).
114
115 <Aside title="Or assign it to g1t">
116 With an Anthropic key under the workspace's [**AI**](/guides/ai/)
117 settings, **Assign to g1t** in the issue's sidebar starts a session on
118 that account, as you, and its card shows in the issue's conversation.
119 See [Assign g1t](/guides/sessions/#assign-g1t-or-ask-it-in-the-thread).
120 </Aside>
121
1226. **Review and merge**
123
124 Open the pull request. **Files changed** shows what it did, and
125 **Session** shows how: its prompts, reasoning and tool calls. Choose
126 **Merge**, or turn on **auto-merge** to have it land once its required
127 checks pass. The issue closes, recording which pull request resolved it.
128
129</Steps>
130
131## Bring your team
132
133Choose **Chat** in the rail. Every workspace starts with `#general`, and
134Chat is free on every plan. Adding people to a workspace comes with
135[the g1t plan](/guides/usage-and-billing/#the-g1t-plan); on a free one,
136[invite a friend](/guides/authentication/#invite-a-friend) to g1t instead,
137or open a [public channel](/guides/chat/#public-channels) that anyone signed in to g1t can join. See
138[Chat](/guides/chat/).
139
140## Next
141
142- [Build and ship an app with an agent](/guides/build-and-ship/): from an empty folder to a deployed app.
143- [How g1t works](/concepts/overview/): issues, pull requests, checks, review and merging.
144- [Connect a coding agent](/guides/bring-your-own-agent/): access, repository instructions and recording sessions.
145- [GitHub Actions](/guides/actions/): your workflows, most unchanged.
146- [MCP tools](/reference/mcp/) and the [API](/reference/api/): everything above, from code.