Skip to content
199 linesCodeBlameRaw

Pick any line to see why it is the way it is: the commit, the pull request and issue it came from, and what the agent was thinking.

Commit pages credit co-authors instead of printing their trailers1// @ts-check
2import starlight from '@astrojs/starlight';
3import { defineConfig } from 'astro/config';
4
Merge branch 'worktree-agent-ab2e39e11a6493412'5import { generateApiReference } from './scripts/api-reference.mjs';
6
7// A page per REST operation, written from the OpenAPI document.
8const apiGroups = generateApiReference();
9
Commit pages credit co-authors instead of printing their trailers10export default defineConfig({
11 site: 'https://docs.g1t.sh',
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent12 // Pages that moved, so links already shared still arrive.
13 redirects: {
14 '/guides/g1t-agents/': '/guides/working-with-g1t/',
g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them.15 '/guides/inbox/': '/guides/notifications/',
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent16 },
Commit pages credit co-authors instead of printing their trailers17 integrations: [
18 starlight({
19 title: 'g1t docs',
Chat and workspace agents: channels, DMs and named agents you talk to20 description: 'Guides and reference for g1t, the workspace where a team and its agents talk, work and ship.',
Commit pages credit co-authors instead of printing their trailers21 components: {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look22 Footer: './src/components/Footer.astro',
23 Head: './src/components/Head.astro',
Docs in the shape of docs.continue.dev24 Header: './src/components/Header.astro',
25 PageTitle: './src/components/PageTitle.astro',
Commit pages credit co-authors instead of printing their trailers26 SiteTitle: './src/components/SiteTitle.astro',
27 SocialIcons: './src/components/SocialIcons.astro',
28 },
Docs in the shape of docs.continue.dev29 // Each tab under the header shows its own part of the sidebar.
30 routeMiddleware: './src/route-data.ts',
Commit pages credit co-authors instead of printing their trailers31 expressiveCode: {
32 themes: ['github-dark-default'],
Docs in the shape of docs.continue.dev33 // Plain panels with a copy button, without window chrome.
34 defaultProps: { frame: 'none' },
Commit pages credit co-authors instead of printing their trailers35 styleOverrides: {
36 borderRadius: '0.75rem',
37 borderColor: 'var(--g1t-line)',
38 codeBackground: 'var(--g1t-surface)',
39 codeFontSize: '0.8125rem',
40 frames: {
41 editorBackground: 'var(--g1t-surface)',
42 terminalBackground: 'var(--g1t-surface)',
43 terminalTitlebarBackground: 'var(--g1t-raised)',
44 terminalTitlebarBorderBottomColor: 'var(--g1t-line)',
45 editorTabBarBackground: 'var(--g1t-raised)',
46 shadowColor: 'transparent',
47 },
48 },
49 },
50 logo: { src: '@g1t/theme/mark.svg', alt: '' },
51 favicon: '/favicon.svg',
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look52 customCss: ['@g1t/theme/fonts.css', '@g1t/theme/tokens.css', './src/styles/g1t.css'],
Commit pages credit co-authors instead of printing their trailers53 editLink: {
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look54 baseUrl: 'https://g1t.sh/flagon-io/g1t/blob/main/apps/docs/',
Commit pages credit co-authors instead of printing their trailers55 },
56 lastUpdated: true,
57 head: [
The fleet: g1t's new mark58 { tag: 'link', attrs: { rel: 'icon', href: '/favicon.ico', sizes: '32x32' } },
59 { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '192x192', href: '/icon-192.png' } },
Agents mode: an overview of every agent's work and spend, and each agent's sessions, memory, routines, spend, activity and versions60 { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '512x512', href: '/icon-512.png' } },
61 { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' } },
62 { tag: 'link', attrs: { rel: 'manifest', href: '/site.webmanifest' } },
63 { tag: 'meta', attrs: { name: 'theme-color', content: '#0f0f11' } },
Commit pages credit co-authors instead of printing their trailers64 ],
65 sidebar: [
66 {
67 label: 'Get started',
68 items: [
69 { label: 'Quickstart', slug: 'quickstart' },
70 { label: 'How g1t works', slug: 'concepts/overview' },
g1t is described as the product it is in alpha, and its shell takes the new shape: the README, the docs home and docs/PLAN.md label every feature Live, Preview or Coming; a floating dock with the g1t mark, Today, Chat, Notifications, Agents, Code, Artifacts, your pinned apps and the Apps launcher, with People, Workspace and the account menu (now holding help) at its foot; the workspace's logo and switcher heading a flat sidebar that folds away with Ctrl B, or leading the header's breadcrumbs where there is none; the page in a rounded panel with a full-width header; Today as the front page, with first-time acceptance of agents' pull requests, what needs you and what's at stake, spend today and one item to start with, every number from a service; Notifications in place of the Inbox at /notifications; a bottom bar and More sheet on phones; and sign-in, sign-up, two-factor, reset, invites and choosing a workspace on standalone pages with no app around them.71 { label: 'Today', slug: 'guides/today' },
72 { label: 'Notifications', slug: 'guides/notifications' },
Search across all of g1t, Explore, and a command palette73 { label: 'Search and Explore', slug: 'guides/search' },
status.g1t.sh with incident management, invites that land you in the workspace, settings as pages, usage without quotas74 { label: 'Status and incidents', slug: 'guides/status' },
Commit pages credit co-authors instead of printing their trailers75 ],
76 },
77 {
Chat and workspace agents: channels, DMs and named agents you talk to78 label: 'Chat and agents',
79 items: [
80 { label: 'Chat', slug: 'guides/chat' },
81 { label: 'Agents', slug: 'guides/agents' },
Agents mode: an overview of every agent's work and spend, and each agent's sessions, memory, routines, spend, activity and versions82 { label: 'Sessions', slug: 'guides/agent-sessions' },
83 { label: 'Agent memory', slug: 'guides/agent-memory' },
84 { label: 'Routines', slug: 'guides/agent-routines' },
85 { label: 'Agent budgets and spend', slug: 'guides/agent-budgets' },
Chat and workspace agents: channels, DMs and named agents you talk to86 { label: 'What agents can do for whom', slug: 'guides/agent-access' },
The Artifacts guide explains home, the sidebar, sharing and access requests, Private, spaces with Editors can share, docs, agents and writing a thread up, links in chat, history, templates, the trash and export, in place of the Docs guide, whose links now go to it.87 { label: 'Artifacts', slug: 'guides/artifacts' },
Chat and workspace agents: channels, DMs and named agents you talk to88 { label: 'Agents in your chat app', slug: 'guides/chat-app', badge: { text: 'Soon', variant: 'default' } },
89 ],
90 },
91 {
Projects: what a workspace builds and runs, first on every page92 label: 'Projects',
93 items: [
94 { label: 'Projects', slug: 'guides/projects' },
95 { label: 'Deployments', slug: 'guides/deployments' },
Merge branch 'main' into worktree-agent-a69aeabc4b0deeb9796 { label: 'Deployments API', slug: 'guides/deployments-api' },
Packages, with a container registry on g1t.sh; workspaces deleted whole and kept 30 days; Members for every member97 { label: 'Packages', slug: 'guides/packages' },
98 { label: 'Container images', slug: 'guides/containers' },
npm on g1t.sh: publish and install @<workspace>/<name> with the npm CLI and a g1t token99 { label: 'npm', slug: 'guides/npm' },
Cargo on g1t.sh: a sparse registry per workspace, cargo publish/add/yank/search with a g1t token; npm rows show their version100 { label: 'Cargo', slug: 'guides/cargo' },
Composer from the workspace's own repositories, and go get from g1t.sh101 { label: 'Composer', slug: 'guides/composer' },
Merge branch 'worktree-agent-a6a121745e81f639f'102 { label: 'Maven', slug: 'guides/maven' },
103 { label: 'NuGet', slug: 'guides/nuget' },
104 { label: 'RubyGems', slug: 'guides/rubygems' },
Composer from the workspace's own repositories, and go get from g1t.sh105 { label: 'Go modules', slug: 'guides/go' },
Projects: what a workspace builds and runs, first on every page106 { label: 'Secrets and variables', slug: 'guides/secrets-and-variables' },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar107 ],
108 },
109 {
110 label: 'Security',
111 items: [
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API112 { label: 'Security', slug: 'guides/security' },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar113 { label: 'Dependency updates', slug: 'guides/dependency-updates' },
114 { label: 'Secret protection', slug: 'guides/security/secret-protection' },
115 { label: 'Code scanning', slug: 'guides/security/code-scanning' },
116 { label: 'Supply chain', slug: 'guides/security/supply-chain' },
117 { label: 'Security overview', slug: 'guides/security/security-overview' },
118 { label: "What's free and what's paid", slug: 'guides/security/pricing' },
Projects: what a workspace builds and runs, first on every page119 ],
120 },
121 {
Chat and workspace agents: channels, DMs and named agents you talk to122 label: 'Agents on code',
Commit pages credit co-authors instead of printing their trailers123 items: [
g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent124 { label: "g1t's agent", slug: 'guides/working-with-g1t' },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API125 { label: 'Guardrails', slug: 'guides/guardrails' },
Commit pages credit co-authors instead of printing their trailers126 { label: 'Outcomes and plans', slug: 'guides/outcomes' },
127 { label: 'Talking to agents', slug: 'guides/talking-to-agents' },
Agents and memory, checks and conflicts, profiles, slug renames, custom domains128 { label: 'Agents, sessions and memory', slug: 'guides/agents-and-memory' },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API129 { label: 'Context hub', slug: 'guides/context-hub' },
Commit pages credit co-authors instead of printing their trailers130 { label: 'Bring your own agent', slug: 'guides/bring-your-own-agent' },
131 ],
132 },
133 {
134 label: 'Connect your tools',
135 items: [
136 { label: 'Integrations', slug: 'guides/integrations' },
137 { label: 'Model providers', slug: 'guides/models' },
Merge the AI Gateway: Anthropic's Messages API on a workspace's tokens138 { label: 'AI Gateway', slug: 'guides/ai-gateway' },
Webhooks: every event, to your own addresses, signed and retried139 { label: 'Webhooks', slug: 'guides/webhooks' },
GitHub Actions on g1t, part three: .g1t/workflows, the pages, the docs140 { label: 'GitHub Actions', slug: 'guides/actions' },
Fast pages, required checks on the branch, self-hosted runners, honest incidents141 { label: 'Self-hosted runners', slug: 'guides/self-hosted-runners' },
Commit pages credit co-authors instead of printing their trailers142 ],
143 },
144 {
145 label: 'Landing changes',
146 items: [
Agents and memory, checks and conflicts, profiles, slug renames, custom domains147 { label: 'Pull requests and checks', slug: 'guides/pull-requests' },
Merge checks: statuses and check runs on every commit148 { label: 'Checks', slug: 'guides/checks' },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar149 { label: 'Pull requests into other branches', slug: 'guides/base-branches' },
150 { label: 'Labels', slug: 'guides/labels' },
151 { label: 'Milestones', slug: 'guides/milestones' },
Commit pages credit co-authors instead of printing their trailers152 { label: 'The merge queue', slug: 'guides/merge-queue' },
Merge rulesets: branch and tag rules, agent-first, enforced on push and merge153 { label: 'Rules', slug: 'guides/rules' },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar154 { label: 'CODEOWNERS', slug: 'guides/codeowners' },
Commit pages credit co-authors instead of printing their trailers155 { label: 'Sessions and why-blame', slug: 'guides/why-blame' },
156 { label: 'Forks and branches', slug: 'concepts/forks' },
157 ],
158 },
159 {
160 label: 'Workspaces',
161 items: [
162 { label: 'Accounts and sign-in', slug: 'guides/authentication' },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look163 { label: 'GitHub', slug: 'guides/github' },
Merge branch 'mirroring' into artifacts-mode164 { label: 'Mirroring', slug: 'guides/mirroring' },
Commit pages credit co-authors instead of printing their trailers165 { label: 'Workspaces and tokens', slug: 'guides/workspaces' },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look166 { label: 'Access and roles', slug: 'guides/access-and-roles' },
Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar167 { label: 'Teams', slug: 'guides/teams' },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look168 { label: 'Managing a repository', slug: 'guides/managing-repositories' },
Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97169 { label: 'Releases', slug: 'guides/releases' },
Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look170 { label: 'Transferring a repository', slug: 'guides/transferring-repositories' },
Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API171 { label: 'Audit log', slug: 'guides/audit-log' },
Commit pages credit co-authors instead of printing their trailers172 { label: 'Usage and billing', slug: 'guides/usage-and-billing' },
173 { label: 'Git', slug: 'guides/git' },
Running g1t yourself: the design, a docker compose proof, and a guide to what works today174 { label: 'Run g1t yourself', slug: 'guides/self-hosting' },
Commit pages credit co-authors instead of printing their trailers175 ],
176 },
177 {
178 label: 'Reference',
179 items: [
180 { label: 'API overview', slug: 'reference/api' },
181 { label: 'MCP tools', slug: 'reference/mcp' },
Merge branch 'worktree-agent-a8752162fea25f63f' into spend-guardrails182 { label: 'Rate limits', slug: 'reference/rate-limits' },
Merge branch 'worktree-agent-ab2e39e11a6493412'183 { label: 'Try it in the explorer', link: '/api/reference/', attrs: { target: '_self' } },
Commit pages credit co-authors instead of printing their trailers184 { label: 'OpenAPI document', link: 'https://api.g1t.sh/openapi.json' },
185 { label: 'llms.txt', link: 'https://g1t.sh/llms.txt' },
186 ],
187 },
Fast pages, required checks on the branch, self-hosted runners, honest incidents188 {
189 label: 'About',
What g1t can't do yet, and an open letter to Cloudflare190 items: [
191 { label: "What g1t can't do yet", slug: 'about/limitations' },
192 { label: 'An open letter to Cloudflare', slug: 'about/open-letter-to-cloudflare' },
193 ],
Fast pages, required checks on the branch, self-hosted runners, honest incidents194 },
Merge branch 'worktree-agent-ab2e39e11a6493412'195 ...apiGroups,
Commit pages credit co-authors instead of printing their trailers196 ],
197 }),
198 ],
199});

This file's history is long; its oldest lines are credited to the oldest commit read.