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
288 linesCodeBlameRaw
1// @ts-check
2import starlight from '@astrojs/starlight';
3import { defineConfig } from 'astro/config';
4
5import { generateApiReference } from './scripts/api-reference.mjs';
6
7// A page per REST operation, written from the OpenAPI document.
8const apiGroups = generateApiReference();
9
10export default defineConfig({
11 site: 'https://docs.g1t.sh',
12 // Pages that moved, so links already shared still arrive.
13 redirects: {
14 '/guides/inbox/': '/guides/notifications/',
15 '/guides/mirroring/': '/guides/github/',
16 '/guides/today/': '/guides/home/',
17 // g1t no longer runs agents of its own: coding agents connect to it.
18 '/guides/g1t-agents/': '/guides/bring-your-own-agent/',
19 '/guides/working-with-g1t/': '/guides/bring-your-own-agent/',
20 '/guides/agents/': '/guides/bring-your-own-agent/',
21 '/guides/agent-abilities/': '/guides/bring-your-own-agent/',
22 '/guides/agent-access/': '/guides/bring-your-own-agent/',
23 '/guides/agent-memory/': '/guides/bring-your-own-agent/',
24 '/guides/agent-routines/': '/guides/bring-your-own-agent/',
25 '/guides/agent-sessions/': '/guides/why-blame/',
26 '/guides/agent-skills/': '/guides/bring-your-own-agent/',
27 '/guides/agent-budgets/': '/guides/usage-and-billing/',
28 '/guides/agents-and-memory/': '/guides/bring-your-own-agent/',
29 '/guides/talking-to-agents/': '/guides/bring-your-own-agent/',
30 '/guides/chat-app/': '/guides/chat/',
31 '/guides/customize/': '/guides/bring-your-own-agent/',
32 '/guides/marketplace/': '/guides/bring-your-own-agent/',
33 '/guides/models/': '/guides/ai/',
34 '/guides/ai-gateway/': '/guides/ai/',
35 '/guides/context-hub/': '/guides/bring-your-own-agent/',
36 // Project and workspace memory is gone: harnesses keep their own.
37 '/guides/memory/': '/guides/bring-your-own-agent/',
38 '/guides/spend/': '/guides/usage-and-billing/',
39 '/guides/outcomes/': '/guides/milestones/',
40 // Issues became workspace work items: their operations moved with them.
41 '/reference/api/issues/list-issues/': '/reference/api/work-items/list-work-items/',
42 '/reference/api/issues/create-issue/': '/reference/api/work-items/open-work-item/',
43 '/reference/api/issues/get-issue/': '/reference/api/work-items/get-work-item/',
44 '/reference/api/issues/update-issue/': '/reference/api/work-items/update-work-item/',
45 '/reference/api/issues/close-issue/': '/reference/api/work-items/close-work-item/',
46 '/reference/api/issues/reopen-issue/': '/reference/api/work-items/reopen-work-item/',
47 '/reference/api/integrations/import-issue/': '/reference/api/work-items/import-work-items/',
48 '/reference/api/issues/list-issue-labels/': '/reference/api/work-items/list-work-item-labels/',
49 '/reference/api/issues/add-issue-labels/': '/reference/api/work-items/add-work-item-labels/',
50 '/reference/api/issues/set-issue-labels/': '/reference/api/work-items/set-work-item-labels/',
51 '/reference/api/issues/remove-issue-labels/': '/reference/api/work-items/remove-work-item-labels/',
52 '/reference/api/issues/remove-issue-label/': '/reference/api/work-items/remove-work-item-label/',
53 '/reference/api/issues/add-comment/': '/reference/api/work-items/add-work-item-comment/',
54 '/reference/api/issues/edit-comment/': '/reference/api/work-items/edit-work-item-comment/',
55 '/reference/api/issues/delete-comment/': '/reference/api/work-items/delete-work-item-comment/',
56 '/reference/api/issues/react/': '/reference/api/work-items/react-to-work-item/',
57 '/reference/api/issues/upload-attachment/': '/reference/api/work-items/upload-attachment/',
58 '/reference/api/decisions-and-why/list-issue-decisions/': '/reference/api/work-items/list-work-item-decisions/',
59 '/reference/api/claims-and-work/get-work/': '/reference/api/work-items/get-work/',
60 '/reference/api/claims-and-work/claim-issue/': '/reference/api/work-items/claim-work-item/',
61 '/reference/api/claims-and-work/claim-new-issue/': '/reference/api/work-items/claim-new-work-item/',
62 '/reference/api/claims-and-work/list-claims/': '/reference/api/work-items/list-claims/',
63 '/reference/api/claims-and-work/release-claim/': '/reference/api/work-items/release-claim/',
64 '/reference/api/claims-and-work/hand-off-issue/': '/reference/api/work-items/hand-off-work-item/',
65 '/reference/api/notifications/get-issue-subscription/': '/reference/api/notifications/get-work-item-subscription/',
66 '/reference/api/notifications/set-issue-subscription/': '/reference/api/notifications/set-work-item-subscription/',
67 '/reference/api/notifications/delete-issue-subscription/': '/reference/api/notifications/delete-work-item-subscription/',
68 },
69 integrations: [
70 starlight({
71 title: 'g1t docs',
72 description: 'Guides and reference for g1t, the code platform for your team and its coding agents.',
73 components: {
74 Footer: './src/components/Footer.astro',
75 Head: './src/components/Head.astro',
76 Header: './src/components/Header.astro',
77 PageTitle: './src/components/PageTitle.astro',
78 SiteTitle: './src/components/SiteTitle.astro',
79 SocialIcons: './src/components/SocialIcons.astro',
80 },
81 // Each tab under the header shows its own part of the sidebar.
82 routeMiddleware: './src/route-data.ts',
83 expressiveCode: {
84 // Dark first, as the base; the light one where the page is light.
85 // Starlight switches between them by <html data-theme>.
86 themes: ['github-dark-default', 'github-light-default'],
87 useDarkModeMediaQuery: false,
88 // Plain panels with a copy button, without window chrome.
89 defaultProps: { frame: 'none' },
90 styleOverrides: {
91 borderRadius: '0.75rem',
92 borderColor: 'var(--g1t-line)',
93 codeBackground: 'var(--g1t-surface)',
94 codeFontSize: '0.8125rem',
95 frames: {
96 editorBackground: 'var(--g1t-surface)',
97 terminalBackground: 'var(--g1t-surface)',
98 terminalTitlebarBackground: 'var(--g1t-raised)',
99 terminalTitlebarBorderBottomColor: 'var(--g1t-line)',
100 editorTabBarBackground: 'var(--g1t-raised)',
101 shadowColor: 'transparent',
102 },
103 },
104 },
105 logo: { src: '@g1t/theme/mark.svg', alt: '' },
106 favicon: '/favicon.svg',
107 customCss: [
108 '@g1t/theme/fonts.css',
109 '@g1t/theme/tokens.css',
110 './src/styles/light.css',
111 './src/styles/g1t.css',
112 ],
113 editLink: {
114 baseUrl: 'https://g1t.sh/flagon-io/g1t/blob/main/apps/docs/',
115 },
116 lastUpdated: true,
117 head: [
118 { tag: 'link', attrs: { rel: 'icon', href: '/favicon.ico', sizes: '32x32' } },
119 { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '192x192', href: '/icon-192.png' } },
120 { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '512x512', href: '/icon-512.png' } },
121 { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' } },
122 { tag: 'link', attrs: { rel: 'manifest', href: '/site.webmanifest' } },
123 // The browser's own bars, in the page's colour for the system's setting.
124 { tag: 'meta', attrs: { name: 'theme-color', content: '#0f0f11', media: '(prefers-color-scheme: dark)' } },
125 { tag: 'meta', attrs: { name: 'theme-color', content: '#fbfbfa', media: '(prefers-color-scheme: light)' } },
126 ],
127 sidebar: [
128 {
129 label: 'Get started',
130 items: [
131 { label: 'Quickstart', slug: 'quickstart' },
132 { label: 'How g1t works', slug: 'concepts/overview' },
133 { label: 'The g1t CLI', slug: 'guides/cli' },
134 { label: 'Home', slug: 'guides/home' },
135 { label: 'Work items', slug: 'guides/work-items' },
136 { label: 'Ask g1t', slug: 'guides/ask' },
137 { label: 'AI providers', slug: 'guides/ai' },
138 { label: 'Notifications', slug: 'guides/notifications' },
139 { label: 'The desktop app', slug: 'guides/desktop' },
140 { label: 'The phone app', slug: 'guides/mobile' },
141 { label: 'Search and Explore', slug: 'guides/search' },
142 { label: 'Status and incidents', slug: 'guides/status' },
143 ],
144 },
145 {
146 label: 'Chat',
147 items: [
148 { label: 'Chat', slug: 'guides/chat' },
149 { label: 'Artifacts', slug: 'guides/artifacts' },
150 ],
151 },
152 {
153 label: 'Projects',
154 items: [
155 { label: 'Projects', slug: 'guides/projects' },
156 { label: 'Deployments', slug: 'guides/deployments' },
157 { label: 'Deployments API', slug: 'guides/deployments-api' },
158 { label: 'Observability', slug: 'guides/observability' },
159 { label: 'Packages', slug: 'guides/packages' },
160 { label: 'Container images', slug: 'guides/containers' },
161 { label: 'npm', slug: 'guides/npm' },
162 { label: 'Cargo', slug: 'guides/cargo' },
163 { label: 'Composer', slug: 'guides/composer' },
164 { label: 'Maven', slug: 'guides/maven' },
165 { label: 'NuGet', slug: 'guides/nuget' },
166 { label: 'RubyGems', slug: 'guides/rubygems' },
167 { label: 'Go modules', slug: 'guides/go' },
168 { label: 'Secrets and variables', slug: 'guides/secrets-and-variables' },
169 ],
170 },
171 {
172 label: 'Security',
173 items: [
174 { label: 'Security', slug: 'guides/security' },
175 { label: 'Dependency updates', slug: 'guides/dependency-updates' },
176 { label: 'Secret protection', slug: 'guides/security/secret-protection' },
177 { label: 'Code scanning', slug: 'guides/security/code-scanning' },
178 { label: 'Supply chain', slug: 'guides/security/supply-chain' },
179 { label: 'Advisories and reporting', slug: 'guides/security/advisories' },
180 { label: 'Security overview', slug: 'guides/security/security-overview' },
181 { label: "What's free and what's paid", slug: 'guides/security/pricing' },
182 ],
183 },
184 {
185 label: 'Coding agents',
186 items: [
187 { label: 'Connect a coding agent', slug: 'guides/bring-your-own-agent' },
188 { label: 'Build and ship an app with an agent', slug: 'guides/build-and-ship' },
189 { label: 'Claude Code plugin', slug: 'guides/claude-code-plugin' },
190 { label: 'Sessions, claims and dependencies', slug: 'guides/sessions' },
191 { label: 'Sessions and why-blame', slug: 'guides/why-blame' },
192 ],
193 },
194 {
195 label: 'Connect your tools',
196 items: [
197 { label: 'Integrations', slug: 'guides/integrations' },
198 { label: 'Webhooks', slug: 'guides/webhooks' },
199 { label: 'GitHub Actions', slug: 'guides/actions' },
200 { label: 'Self-hosted runners', slug: 'guides/self-hosted-runners' },
201 { label: 'Guardrails', slug: 'guides/guardrails' },
202 ],
203 },
204 {
205 label: 'Landing changes',
206 items: [
207 { label: 'Pull requests and checks', slug: 'guides/pull-requests' },
208 { label: 'Checks', slug: 'guides/checks' },
209 { label: 'Pull requests into other branches', slug: 'guides/base-branches' },
210 { label: 'Labels', slug: 'guides/labels' },
211 { label: 'Milestones', slug: 'guides/milestones' },
212 { label: 'The merge queue', slug: 'guides/merge-queue' },
213 { label: 'Rules', slug: 'guides/rules' },
214 { label: 'CODEOWNERS', slug: 'guides/codeowners' },
215 { label: 'Forks and working copies', slug: 'concepts/forks' },
216 ],
217 },
218 {
219 label: 'Workspaces',
220 items: [
221 { label: 'Accounts and sign-in', slug: 'guides/authentication' },
222 { label: 'GitHub', slug: 'guides/github' },
223 { label: 'Workspaces and tokens', slug: 'guides/workspaces' },
224 { label: 'Access and roles', slug: 'guides/access-and-roles' },
225 { label: 'Permissions', slug: 'guides/permissions' },
226 { label: 'Single sign-on', slug: 'guides/single-sign-on' },
227 { label: 'Teams', slug: 'guides/teams' },
228 { label: 'People and teams', slug: 'guides/people-and-teams' },
229 { label: 'Managing a repository', slug: 'guides/managing-repositories' },
230 { label: 'Releases', slug: 'guides/releases' },
231 { label: 'Forking a repository', slug: 'guides/forking-repositories' },
232 { label: 'Transferring a repository', slug: 'guides/transferring-repositories' },
233 { label: 'Audit log', slug: 'guides/audit-log' },
234 { label: 'Usage and billing', slug: 'guides/usage-and-billing' },
235 { label: 'Git', slug: 'guides/git' },
236 ],
237 },
238 {
239 label: 'Run g1t yourself',
240 items: [
241 { label: 'With Docker Compose', slug: 'guides/self-hosting' },
242 { label: 'How a self-hosted g1t runs', slug: 'guides/self-hosting-architecture' },
243 { label: 'Deploy to Cloudflare', slug: 'guides/deploy-to-cloudflare' },
244 ],
245 },
246 {
247 label: 'Architecture',
248 items: [
249 { label: 'Overview', slug: 'architecture/overview' },
250 { label: 'How a request is served', slug: 'architecture/requests' },
251 { label: 'Services and contracts', slug: 'architecture/services' },
252 { label: 'Git', slug: 'architecture/git' },
253 { label: 'Events', slug: 'architecture/events' },
254 { label: 'Work and the merge queue', slug: 'architecture/work' },
255 { label: 'Actions, runners and sandboxes', slug: 'architecture/compute' },
256 { label: 'Deployments and telemetry', slug: 'architecture/deployments' },
257 { label: 'Data and storage', slug: 'architecture/data' },
258 { label: 'Identity and access', slug: 'architecture/identity' },
259 { label: 'How g1t ships', slug: 'architecture/shipping' },
260 ],
261 },
262 {
263 label: 'Reference',
264 items: [
265 { label: 'API overview', slug: 'reference/api' },
266 { label: 'MCP tools', slug: 'reference/mcp' },
267 { label: 'CLI commands', slug: 'reference/cli' },
268 { label: 'Developer resources', slug: 'reference/developers' },
269 { label: 'Versioning policy', slug: 'reference/versioning' },
270 { label: 'Rate limits', slug: 'reference/rate-limits' },
271 { label: 'Try it in the explorer', link: '/api/reference/', attrs: { target: '_self' } },
272 { label: 'OpenAPI document', link: 'https://api.g1t.sh/openapi.json' },
273 { label: 'llms.txt', link: 'https://g1t.sh/llms.txt' },
274 ],
275 },
276 {
277 label: 'About',
278 items: [
279 { label: "What g1t can't do yet", slug: 'about/limitations' },
280 { label: 'Issues became work items', slug: 'about/issues-became-work-items' },
281 { label: 'An open letter to Cloudflare', slug: 'about/open-letter-to-cloudflare' },
282 ],
283 },
284 ...apiGroups,
285 ],
286 }),
287 ],
288});