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.
| Topics sit in About on the files pages, under the description | 1 | // @ts-check |
| 2 | import starlight from '@astrojs/starlight'; | |
| 3 | import { defineConfig } from 'astro/config'; | |
| 4 | ||
| 5 | import { generateApiReference } from './scripts/api-reference.mjs'; | |
| 6 | ||
| 7 | // A page per REST operation, written from the OpenAPI document. | |
| 8 | const apiGroups = generateApiReference(); | |
| 9 | ||
| 10 | export default defineConfig({ | |
| 11 | site: 'https://docs.g1t.sh', | |
| 12 | // Pages that moved, so links already shared still arrive. | |
| 13 | redirects: { | |
| 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. | 14 | '/guides/inbox/': '/guides/notifications/', |
| The front page is Home: where you're needed comes first, however long ago it started, with what's at stake and how long it has waited; then what happened since you were last here, in words, with the agent work that settled, what landed, what deployed, what was decided and what was spent, switchable to the last 24 hours or 7 days; then what's running now. Your last visit is kept with your account, so it's the same on every device; Today's old address leads here. The home guide says how. | 15 | '/guides/today/': '/guides/home/', |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 16 | // g1t no longer runs agents of its own: coding agents connect to it. |
| 17 | '/guides/g1t-agents/': '/guides/bring-your-own-agent/', | |
| 18 | '/guides/working-with-g1t/': '/guides/bring-your-own-agent/', | |
| 19 | '/guides/agents/': '/guides/bring-your-own-agent/', | |
| 20 | '/guides/agent-abilities/': '/guides/bring-your-own-agent/', | |
| 21 | '/guides/agent-access/': '/guides/bring-your-own-agent/', | |
| 22 | '/guides/agent-memory/': '/guides/memory/', | |
| 23 | '/guides/agent-routines/': '/guides/bring-your-own-agent/', | |
| 24 | '/guides/agent-sessions/': '/guides/why-blame/', | |
| 25 | '/guides/agent-skills/': '/guides/bring-your-own-agent/', | |
| 26 | '/guides/agent-budgets/': '/guides/usage-and-billing/', | |
| 27 | '/guides/agents-and-memory/': '/guides/memory/', | |
| 28 | '/guides/talking-to-agents/': '/guides/bring-your-own-agent/', | |
| 29 | '/guides/chat-app/': '/guides/chat/', | |
| 30 | '/guides/customize/': '/guides/bring-your-own-agent/', | |
| 31 | '/guides/marketplace/': '/guides/bring-your-own-agent/', | |
| 32 | '/guides/models/': '/guides/integrations/', | |
| 33 | '/guides/ai-gateway/': '/guides/integrations/', | |
| 34 | '/guides/context-hub/': '/guides/memory/', | |
| 35 | '/guides/spend/': '/guides/usage-and-billing/', | |
| 36 | '/guides/outcomes/': '/guides/milestones/', | |
| Topics sit in About on the files pages, under the description | 37 | }, |
| 38 | integrations: [ | |
| 39 | starlight({ | |
| 40 | title: 'g1t docs', | |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 41 | description: 'Guides and reference for g1t, where a team and its coding agents talk, build and ship.', |
| Topics sit in About on the files pages, under the description | 42 | components: { |
| 43 | Footer: './src/components/Footer.astro', | |
| 44 | Head: './src/components/Head.astro', | |
| 45 | Header: './src/components/Header.astro', | |
| 46 | PageTitle: './src/components/PageTitle.astro', | |
| 47 | SiteTitle: './src/components/SiteTitle.astro', | |
| 48 | SocialIcons: './src/components/SocialIcons.astro', | |
| 49 | }, | |
| 50 | // Each tab under the header shows its own part of the sidebar. | |
| 51 | routeMiddleware: './src/route-data.ts', | |
| 52 | expressiveCode: { | |
| docs.g1t.sh and status.g1t.sh follow your system's light or dark setting, and each has an Auto, Light and Dark switch that this browser remembers: the docs' in the header (at the foot of the menu on a phone), with code, search, the API reference and its explorer in both themes; the status page's in its header, chosen before anything is drawn; the workspaces guide says where. | 53 | // Dark first, as the base; the light one where the page is light. |
| 54 | // Starlight switches between them by <html data-theme>. | |
| 55 | themes: ['github-dark-default', 'github-light-default'], | |
| 56 | useDarkModeMediaQuery: false, | |
| Topics sit in About on the files pages, under the description | 57 | // Plain panels with a copy button, without window chrome. |
| 58 | defaultProps: { frame: 'none' }, | |
| 59 | styleOverrides: { | |
| 60 | borderRadius: '0.75rem', | |
| 61 | borderColor: 'var(--g1t-line)', | |
| 62 | codeBackground: 'var(--g1t-surface)', | |
| 63 | codeFontSize: '0.8125rem', | |
| 64 | frames: { | |
| 65 | editorBackground: 'var(--g1t-surface)', | |
| 66 | terminalBackground: 'var(--g1t-surface)', | |
| 67 | terminalTitlebarBackground: 'var(--g1t-raised)', | |
| 68 | terminalTitlebarBorderBottomColor: 'var(--g1t-line)', | |
| 69 | editorTabBarBackground: 'var(--g1t-raised)', | |
| 70 | shadowColor: 'transparent', | |
| 71 | }, | |
| 72 | }, | |
| 73 | }, | |
| 74 | logo: { src: '@g1t/theme/mark.svg', alt: '' }, | |
| 75 | favicon: '/favicon.svg', | |
| docs.g1t.sh and status.g1t.sh follow your system's light or dark setting, and each has an Auto, Light and Dark switch that this browser remembers: the docs' in the header (at the foot of the menu on a phone), with code, search, the API reference and its explorer in both themes; the status page's in its header, chosen before anything is drawn; the workspaces guide says where. | 76 | customCss: [ |
| 77 | '@g1t/theme/fonts.css', | |
| 78 | '@g1t/theme/tokens.css', | |
| 79 | './src/styles/light.css', | |
| 80 | './src/styles/g1t.css', | |
| 81 | ], | |
| Topics sit in About on the files pages, under the description | 82 | editLink: { |
| 83 | baseUrl: 'https://g1t.sh/flagon-io/g1t/blob/main/apps/docs/', | |
| 84 | }, | |
| 85 | lastUpdated: true, | |
| 86 | head: [ | |
| 87 | { tag: 'link', attrs: { rel: 'icon', href: '/favicon.ico', sizes: '32x32' } }, | |
| 88 | { 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 versions | 89 | { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '512x512', href: '/icon-512.png' } }, |
| 90 | { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' } }, | |
| 91 | { tag: 'link', attrs: { rel: 'manifest', href: '/site.webmanifest' } }, | |
| docs.g1t.sh and status.g1t.sh follow your system's light or dark setting, and each has an Auto, Light and Dark switch that this browser remembers: the docs' in the header (at the foot of the menu on a phone), with code, search, the API reference and its explorer in both themes; the status page's in its header, chosen before anything is drawn; the workspaces guide says where. | 92 | // The browser's own bars, in the page's colour for the system's setting. |
| 93 | { tag: 'meta', attrs: { name: 'theme-color', content: '#0f0f11', media: '(prefers-color-scheme: dark)' } }, | |
| 94 | { tag: 'meta', attrs: { name: 'theme-color', content: '#fbfbfa', media: '(prefers-color-scheme: light)' } }, | |
| Topics sit in About on the files pages, under the description | 95 | ], |
| 96 | sidebar: [ | |
| 97 | { | |
| 98 | label: 'Get started', | |
| 99 | items: [ | |
| 100 | { label: 'Quickstart', slug: 'quickstart' }, | |
| 101 | { label: 'How g1t works', slug: 'concepts/overview' }, | |
| The front page is Home: where you're needed comes first, however long ago it started, with what's at stake and how long it has waited; then what happened since you were last here, in words, with the agent work that settled, what landed, what deployed, what was decided and what was spent, switchable to the last 24 hours or 7 days; then what's running now. Your last visit is kept with your account, so it's the same on every device; Today's old address leads here. The home guide says how. | 102 | { label: 'Home', slug: 'guides/home' }, |
| 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. | 103 | { label: 'Notifications', slug: 'guides/notifications' }, |
| preparing for cloud work | 104 | { label: 'The desktop app', slug: 'guides/desktop' }, |
| The phone app: Chat in full with phone notifications, plus Code and Customize (#4) | 105 | { label: 'The phone app', slug: 'guides/mobile' }, |
| Topics sit in About on the files pages, under the description | 106 | { label: 'Search and Explore', slug: 'guides/search' }, |
| 107 | { label: 'Status and incidents', slug: 'guides/status' }, | |
| 108 | ], | |
| 109 | }, | |
| 110 | { | |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 111 | label: 'Chat', |
| Chat and workspace agents: channels, DMs and named agents you talk to | 112 | items: [ |
| 113 | { label: 'Chat', slug: 'guides/chat' }, | |
| 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. | 114 | { label: 'Artifacts', slug: 'guides/artifacts' }, |
| Chat and workspace agents: channels, DMs and named agents you talk to | 115 | ], |
| 116 | }, | |
| 117 | { | |
| Topics sit in About on the files pages, under the description | 118 | label: 'Projects', |
| 119 | items: [ | |
| 120 | { label: 'Projects', slug: 'guides/projects' }, | |
| 121 | { label: 'Deployments', slug: 'guides/deployments' }, | |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 122 | { label: 'Deployments API', slug: 'guides/deployments-api' }, |
| Projects have Observability: their requests, logs, traces, metrics and errors, from apps on g1t.page with nothing to set up, and from software anywhere else over OpenTelemetry. | 123 | { label: 'Observability', slug: 'guides/observability' }, |
| Topics sit in About on the files pages, under the description | 124 | { label: 'Packages', slug: 'guides/packages' }, |
| 125 | { label: 'Container images', slug: 'guides/containers' }, | |
| 126 | { 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 version | 127 | { label: 'Cargo', slug: 'guides/cargo' }, |
| Topics sit in About on the files pages, under the description | 128 | { label: 'Composer', slug: 'guides/composer' }, |
| Merge branch 'worktree-agent-a6a121745e81f639f' | 129 | { label: 'Maven', slug: 'guides/maven' }, |
| 130 | { label: 'NuGet', slug: 'guides/nuget' }, | |
| 131 | { label: 'RubyGems', slug: 'guides/rubygems' }, | |
| Topics sit in About on the files pages, under the description | 132 | { label: 'Go modules', slug: 'guides/go' }, |
| 133 | { label: 'Secrets and variables', slug: 'guides/secrets-and-variables' }, | |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 134 | ], |
| 135 | }, | |
| 136 | { | |
| 137 | label: 'Security', | |
| 138 | items: [ | |
| Topics sit in About on the files pages, under the description | 139 | { label: 'Security', slug: 'guides/security' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 140 | { label: 'Dependency updates', slug: 'guides/dependency-updates' }, |
| 141 | { label: 'Secret protection', slug: 'guides/security/secret-protection' }, | |
| 142 | { label: 'Code scanning', slug: 'guides/security/code-scanning' }, | |
| 143 | { label: 'Supply chain', slug: 'guides/security/supply-chain' }, | |
| Merge remote-tracking branch 'origin/claude/cool-newton-7nm8r9' into claude/cool-newton-7nm8r9 | 144 | { label: 'Advisories and reporting', slug: 'guides/security/advisories' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 145 | { label: 'Security overview', slug: 'guides/security/security-overview' }, |
| 146 | { label: "What's free and what's paid", slug: 'guides/security/pricing' }, | |
| Topics sit in About on the files pages, under the description | 147 | ], |
| 148 | }, | |
| 149 | { | |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 150 | label: 'Coding agents', |
| Topics sit in About on the files pages, under the description | 151 | items: [ |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 152 | { label: 'Connect a coding agent', slug: 'guides/bring-your-own-agent' }, |
| 153 | { label: 'Sessions and why-blame', slug: 'guides/why-blame' }, | |
| 154 | { label: 'Memory', slug: 'guides/memory' }, | |
| Topics sit in About on the files pages, under the description | 155 | ], |
| 156 | }, | |
| 157 | { | |
| 158 | label: 'Connect your tools', | |
| 159 | items: [ | |
| 160 | { label: 'Integrations', slug: 'guides/integrations' }, | |
| 161 | { label: 'Webhooks', slug: 'guides/webhooks' }, | |
| 162 | { label: 'GitHub Actions', slug: 'guides/actions' }, | |
| 163 | { label: 'Self-hosted runners', slug: 'guides/self-hosted-runners' }, | |
| The docs describe g1t as the place your coding agents work, not as an agent of its own. The guides to g1t's hosted agents are gone: agents, their abilities, access, budgets, memory, routines, sessions and skills, talking to agents, working with g1t, Customize, model providers, the AI Gateway, the context hub, spend, plans and the chat app's agent pages. Each old address redirects to the page that now covers what is left of it. | 164 | { label: 'Guardrails', slug: 'guides/guardrails' }, |
| Topics sit in About on the files pages, under the description | 165 | ], |
| 166 | }, | |
| 167 | { | |
| 168 | label: 'Landing changes', | |
| 169 | items: [ | |
| 170 | { label: 'Pull requests and checks', slug: 'guides/pull-requests' }, | |
| Merge checks: statuses and check runs on every commit | 171 | { label: 'Checks', slug: 'guides/checks' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 172 | { label: 'Pull requests into other branches', slug: 'guides/base-branches' }, |
| 173 | { label: 'Labels', slug: 'guides/labels' }, | |
| 174 | { label: 'Milestones', slug: 'guides/milestones' }, | |
| Topics sit in About on the files pages, under the description | 175 | { label: 'The merge queue', slug: 'guides/merge-queue' }, |
| Merge rulesets: branch and tag rules, agent-first, enforced on push and merge | 176 | { label: 'Rules', slug: 'guides/rules' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 177 | { label: 'CODEOWNERS', slug: 'guides/codeowners' }, |
| Topics sit in About on the files pages, under the description | 178 | { label: 'Forks and branches', slug: 'concepts/forks' }, |
| 179 | ], | |
| 180 | }, | |
| 181 | { | |
| 182 | label: 'Workspaces', | |
| 183 | items: [ | |
| 184 | { label: 'Accounts and sign-in', slug: 'guides/authentication' }, | |
| 185 | { label: 'GitHub', slug: 'guides/github' }, | |
| Merge branch 'mirroring' into artifacts-mode | 186 | { label: 'Mirroring', slug: 'guides/mirroring' }, |
| Topics sit in About on the files pages, under the description | 187 | { label: 'Workspaces and tokens', slug: 'guides/workspaces' }, |
| 188 | { label: 'Access and roles', slug: 'guides/access-and-roles' }, | |
| Workspace is the workspace's settings, in one place. Its sidebar is grouped, General, Access, Money, Compute, Code, Agents, Chat, Artifacts, Security and Integrations, every page one click away with no settings inside settings, the groups folding and the owner-only pages hidden from members; what is not here yet is marked Soon with a hint. Members is a list with search and filters for role, two-factor and team, and Invite opens a dialog: who, by username, name or email, their role and a note that goes into the invitation; nothing is filled in inline any more. Invitations is its own page with All, Pending, Accepted, Declined, Expired and Revoked filters that say how many, and each row's menu can copy the link, send it again or revoke it; identity learned to send an invitation again and to carry the note. Permissions gathers every rule about who may do what, by part: Code's base permission and member privileges, who creates teams, who creates channels, and, marked Soon with what applies today, forking private repositories, adding agents to conversations, messaging agents directly, creating spaces and default sharing, creating workspace agents and raising budgets, deploying to production and publishing packages. General lost what moved. The permissions guide is new, and the workspaces, people and teams, access, chat, teams, authentication and billing guides say where things are now. | 189 | { label: 'Permissions', slug: 'guides/permissions' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 190 | { label: 'Teams', slug: 'guides/teams' }, |
| People and teams are front and centre: one directory of people and agents with presence, local time, titles, teams and what each owns; profiles with manager and reports and the agents they work with; an org chart with each team's agents beside the person who leads it; and teams of any mix, with a lead, a channel, a budget agents keep to and the agents on them. Every agent is told its teams each turn (who leads, who owns what, who's around and who to page), and the team page shows exactly what. Member management is Members and invites; the people and teams guide says how. | 191 | { label: 'People and teams', slug: 'guides/people-and-teams' }, |
| Topics sit in About on the files pages, under the description | 192 | { label: 'Managing a repository', slug: 'guides/managing-repositories' }, |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 193 | { label: 'Releases', slug: 'guides/releases' }, |
| Topics sit in About on the files pages, under the description | 194 | { label: 'Transferring a repository', slug: 'guides/transferring-repositories' }, |
| 195 | { label: 'Audit log', slug: 'guides/audit-log' }, | |
| 196 | { label: 'Usage and billing', slug: 'guides/usage-and-billing' }, | |
| 197 | { label: 'Git', slug: 'guides/git' }, | |
| 198 | ], | |
| 199 | }, | |
| 200 | { | |
| The docs folder is gone, and what it held lives where people read it: how a self-hosted g1t runs and how to deploy g1t to Cloudflare are pages on docs.g1t.sh under Run g1t yourself, and speed, rate limits and operating g1t.sh are sections of CONTRIBUTING.md; code that cited a file in docs/ now points to the page or section that covers it, or says what it means itself, and applied migrations and the runner images are left as they were. | 201 | label: 'Run g1t yourself', |
| 202 | items: [ | |
| 203 | { label: 'With Docker Compose', slug: 'guides/self-hosting' }, | |
| 204 | { label: 'How a self-hosted g1t runs', slug: 'guides/self-hosting-architecture' }, | |
| 205 | { label: 'Deploy to Cloudflare', slug: 'guides/deploy-to-cloudflare' }, | |
| 206 | ], | |
| 207 | }, | |
| 208 | { | |
| Topics sit in About on the files pages, under the description | 209 | label: 'Reference', |
| 210 | items: [ | |
| 211 | { label: 'API overview', slug: 'reference/api' }, | |
| 212 | { label: 'MCP tools', slug: 'reference/mcp' }, | |
| Merge branch 'worktree-agent-a8752162fea25f63f' into spend-guardrails | 213 | { label: 'Rate limits', slug: 'reference/rate-limits' }, |
| Topics sit in About on the files pages, under the description | 214 | { label: 'Try it in the explorer', link: '/api/reference/', attrs: { target: '_self' } }, |
| 215 | { label: 'OpenAPI document', link: 'https://api.g1t.sh/openapi.json' }, | |
| 216 | { label: 'llms.txt', link: 'https://g1t.sh/llms.txt' }, | |
| 217 | ], | |
| 218 | }, | |
| 219 | { | |
| 220 | label: 'About', | |
| 221 | items: [ | |
| 222 | { label: "What g1t can't do yet", slug: 'about/limitations' }, | |
| 223 | { label: 'An open letter to Cloudflare', slug: 'about/open-letter-to-cloudflare' }, | |
| 224 | ], | |
| 225 | }, | |
| 226 | ...apiGroups, | |
| 227 | ], | |
| 228 | }), | |
| 229 | ], | |
| 230 | }); |
This file's history is long; its oldest lines are credited to the oldest commit read.