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.
| Sidebar: the panels really slide | 1 | // @ts-check |
| 2 | import starlight from '@astrojs/starlight'; | |
| 3 | import { defineConfig } from 'astro/config'; | |
| 4 | ||
| Merge branch 'worktree-agent-ab2e39e11a6493412' | 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 | ||
| Sidebar: the panels really slide | 10 | export 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-agent | 12 | // 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-agent | 16 | }, |
| Sidebar: the panels really slide | 17 | integrations: [ |
| 18 | starlight({ | |
| 19 | title: 'g1t docs', | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 20 | description: 'Guides and reference for g1t, the workspace where a team and its agents talk, work and ship.', |
| Sidebar: the panels really slide | 21 | components: { |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 22 | Footer: './src/components/Footer.astro', |
| 23 | Head: './src/components/Head.astro', | |
| Sidebar: the panels really slide | 24 | Header: './src/components/Header.astro', |
| 25 | PageTitle: './src/components/PageTitle.astro', | |
| 26 | SiteTitle: './src/components/SiteTitle.astro', | |
| 27 | SocialIcons: './src/components/SocialIcons.astro', | |
| 28 | }, | |
| 29 | // Each tab under the header shows its own part of the sidebar. | |
| 30 | routeMiddleware: './src/route-data.ts', | |
| 31 | 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. | 32 | // Dark first, as the base; the light one where the page is light. |
| 33 | // Starlight switches between them by <html data-theme>. | |
| 34 | themes: ['github-dark-default', 'github-light-default'], | |
| 35 | useDarkModeMediaQuery: false, | |
| Sidebar: the panels really slide | 36 | // Plain panels with a copy button, without window chrome. |
| 37 | defaultProps: { frame: 'none' }, | |
| 38 | styleOverrides: { | |
| 39 | borderRadius: '0.75rem', | |
| 40 | borderColor: 'var(--g1t-line)', | |
| 41 | codeBackground: 'var(--g1t-surface)', | |
| 42 | codeFontSize: '0.8125rem', | |
| 43 | frames: { | |
| 44 | editorBackground: 'var(--g1t-surface)', | |
| 45 | terminalBackground: 'var(--g1t-surface)', | |
| 46 | terminalTitlebarBackground: 'var(--g1t-raised)', | |
| 47 | terminalTitlebarBorderBottomColor: 'var(--g1t-line)', | |
| 48 | editorTabBarBackground: 'var(--g1t-raised)', | |
| 49 | shadowColor: 'transparent', | |
| 50 | }, | |
| 51 | }, | |
| 52 | }, | |
| 53 | logo: { src: '@g1t/theme/mark.svg', alt: '' }, | |
| 54 | 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. | 55 | customCss: [ |
| 56 | '@g1t/theme/fonts.css', | |
| 57 | '@g1t/theme/tokens.css', | |
| 58 | './src/styles/light.css', | |
| 59 | './src/styles/g1t.css', | |
| 60 | ], | |
| Sidebar: the panels really slide | 61 | editLink: { |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 62 | baseUrl: 'https://g1t.sh/flagon-io/g1t/blob/main/apps/docs/', |
| Sidebar: the panels really slide | 63 | }, |
| 64 | lastUpdated: true, | |
| 65 | head: [ | |
| The fleet: g1t's new mark | 66 | { tag: 'link', attrs: { rel: 'icon', href: '/favicon.ico', sizes: '32x32' } }, |
| 67 | { 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 | 68 | { tag: 'link', attrs: { rel: 'icon', type: 'image/png', sizes: '512x512', href: '/icon-512.png' } }, |
| 69 | { tag: 'link', attrs: { rel: 'apple-touch-icon', sizes: '180x180', href: '/apple-touch-icon.png' } }, | |
| 70 | { 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. | 71 | // The browser's own bars, in the page's colour for the system's setting. |
| 72 | { tag: 'meta', attrs: { name: 'theme-color', content: '#0f0f11', media: '(prefers-color-scheme: dark)' } }, | |
| 73 | { tag: 'meta', attrs: { name: 'theme-color', content: '#fbfbfa', media: '(prefers-color-scheme: light)' } }, | |
| Sidebar: the panels really slide | 74 | ], |
| 75 | sidebar: [ | |
| 76 | { | |
| 77 | label: 'Get started', | |
| 78 | items: [ | |
| 79 | { label: 'Quickstart', slug: 'quickstart' }, | |
| 80 | { 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. | 81 | { label: 'Today', slug: 'guides/today' }, |
| 82 | { label: 'Notifications', slug: 'guides/notifications' }, | |
| Search across all of g1t, Explore, and a command palette | 83 | { 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 quotas | 84 | { label: 'Status and incidents', slug: 'guides/status' }, |
| Sidebar: the panels really slide | 85 | ], |
| 86 | }, | |
| 87 | { | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 88 | label: 'Chat and agents', |
| 89 | items: [ | |
| 90 | { label: 'Chat', slug: 'guides/chat' }, | |
| 91 | { 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 versions | 92 | { label: 'Sessions', slug: 'guides/agent-sessions' }, |
| Every agent starts with g1t's foundational skills, playbooks for documents, research, data, code, communication, and files and media, each using only tools the agent already has and saying plainly what isn't possible yet: agents make PDFs, Word documents, spreadsheets, CSV and Markdown files with make_file, kept with a doc in Artifacts and served from g1tusercontent.com; an agent's Skills tab shows what each skill can do and with which tools, and owners turn a skill off per agent; the agent skills guide says how. | 93 | { label: 'Skills', slug: 'guides/agent-skills' }, |
| Agents mode: an overview of every agent's work and spend, and each agent's sessions, memory, routines, spend, activity and versions | 94 | { label: 'Agent memory', slug: 'guides/agent-memory' }, |
| 95 | { label: 'Routines', slug: 'guides/agent-routines' }, | |
| The Spend page says what a workspace spent, where it went and the budgets that hold it, in Workspace under Money: spent at price, agents' spend and the spend limit; by day; by agent, person, channel, model, kind of work and product; budgets from the workspace down to each person, agent and task, with what happens at 100%; the costliest tasks, each with a receipt of every session at the provider's price and what was charged; and how it's priced. Everyone sees what agents spent for them, and owners and billing managers the whole workspace; each person can have a monthly budget agents keep to, and the spend pill in the top bar shows your month or the workspace's against its limit. The spend guide says how. | 96 | { label: 'Spend', slug: 'guides/spend' }, |
| Agents mode: an overview of every agent's work and spend, and each agent's sessions, memory, routines, spend, activity and versions | 97 | { label: 'Agent budgets and spend', slug: 'guides/agent-budgets' }, |
| Chat and workspace agents: channels, DMs and named agents you talk to | 98 | { 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. | 99 | { label: 'Artifacts', slug: 'guides/artifacts' }, |
| Chat and workspace agents: channels, DMs and named agents you talk to | 100 | { label: 'Agents in your chat app', slug: 'guides/chat-app', badge: { text: 'Soon', variant: 'default' } }, |
| 101 | ], | |
| 102 | }, | |
| 103 | { | |
| Projects: what a workspace builds and runs, first on every page | 104 | label: 'Projects', |
| 105 | items: [ | |
| 106 | { label: 'Projects', slug: 'guides/projects' }, | |
| 107 | { label: 'Deployments', slug: 'guides/deployments' }, | |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 108 | { 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 member | 109 | { label: 'Packages', slug: 'guides/packages' }, |
| 110 | { label: 'Container images', slug: 'guides/containers' }, | |
| npm on g1t.sh: publish and install @<workspace>/<name> with the npm CLI and a g1t token | 111 | { 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 | 112 | { label: 'Cargo', slug: 'guides/cargo' }, |
| Composer from the workspace's own repositories, and go get from g1t.sh | 113 | { label: 'Composer', slug: 'guides/composer' }, |
| Merge branch 'worktree-agent-a6a121745e81f639f' | 114 | { label: 'Maven', slug: 'guides/maven' }, |
| 115 | { label: 'NuGet', slug: 'guides/nuget' }, | |
| 116 | { label: 'RubyGems', slug: 'guides/rubygems' }, | |
| Composer from the workspace's own repositories, and go get from g1t.sh | 117 | { label: 'Go modules', slug: 'guides/go' }, |
| Projects: what a workspace builds and runs, first on every page | 118 | { 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 | 119 | ], |
| 120 | }, | |
| 121 | { | |
| 122 | label: 'Security', | |
| 123 | items: [ | |
| Agents get guardrails, run credentials, an audit log, a context hub, repository instructions and mentions; security upkeep; snake_case API | 124 | { label: 'Security', slug: 'guides/security' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 125 | { label: 'Dependency updates', slug: 'guides/dependency-updates' }, |
| 126 | { label: 'Secret protection', slug: 'guides/security/secret-protection' }, | |
| 127 | { label: 'Code scanning', slug: 'guides/security/code-scanning' }, | |
| 128 | { label: 'Supply chain', slug: 'guides/security/supply-chain' }, | |
| 129 | { label: 'Security overview', slug: 'guides/security/security-overview' }, | |
| 130 | { label: "What's free and what's paid", slug: 'guides/security/pricing' }, | |
| Projects: what a workspace builds and runs, first on every page | 131 | ], |
| 132 | }, | |
| 133 | { | |
| Chat and workspace agents: channels, DMs and named agents you talk to | 134 | label: 'Agents on code', |
| Sidebar: the panels really slide | 135 | items: [ |
| g1t is one name: its agent's work, commits and comments show as @g1t, and nobody can claim g1t or g1t-agent | 136 | { 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 API | 137 | { label: 'Guardrails', slug: 'guides/guardrails' }, |
| Sidebar: the panels really slide | 138 | { label: 'Outcomes and plans', slug: 'guides/outcomes' }, |
| 139 | { label: 'Talking to agents', slug: 'guides/talking-to-agents' }, | |
| Agents and memory, checks and conflicts, profiles, slug renames, custom domains | 140 | { 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 API | 141 | { label: 'Context hub', slug: 'guides/context-hub' }, |
| Sidebar: the panels really slide | 142 | { label: 'Bring your own agent', slug: 'guides/bring-your-own-agent' }, |
| 143 | ], | |
| 144 | }, | |
| 145 | { | |
| 146 | label: 'Connect your tools', | |
| 147 | items: [ | |
| The Marketplace is where a workspace finds what to add, reached from Apps: the agent catalog of roles with who already does each job and Add to workspace; every integration with whether it's connected; g1t's own extensions, listed as Soon; and requests, where members ask and owners add or turn down, each told by a notification. Underneath, an extension is a manifest (publisher and tier, source and version from a tag, scopes, the domains its data goes to, its page on g1tusercontent.com, no price) and an install pins its version with an off switch, a budget and the audit log. Apps lists only what was added from the Marketplace, with pins; g1t's own pages stay in their sidebars, and AI Gateway joins Workspace's. The marketplace guide says how. | 148 | { label: 'Marketplace', slug: 'guides/marketplace' }, |
| Sidebar: the panels really slide | 149 | { label: 'Integrations', slug: 'guides/integrations' }, |
| 150 | { label: 'Model providers', slug: 'guides/models' }, | |
| Merge the AI Gateway: Anthropic's Messages API on a workspace's tokens | 151 | { label: 'AI Gateway', slug: 'guides/ai-gateway' }, |
| Sidebar: the panels really slide | 152 | { label: 'Webhooks', slug: 'guides/webhooks' }, |
| 153 | { label: 'GitHub Actions', slug: 'guides/actions' }, | |
| Fast pages, required checks on the branch, self-hosted runners, honest incidents | 154 | { label: 'Self-hosted runners', slug: 'guides/self-hosted-runners' }, |
| Sidebar: the panels really slide | 155 | ], |
| 156 | }, | |
| 157 | { | |
| 158 | label: 'Landing changes', | |
| 159 | items: [ | |
| Agents and memory, checks and conflicts, profiles, slug renames, custom domains | 160 | { label: 'Pull requests and checks', slug: 'guides/pull-requests' }, |
| Merge checks: statuses and check runs on every commit | 161 | { label: 'Checks', slug: 'guides/checks' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 162 | { label: 'Pull requests into other branches', slug: 'guides/base-branches' }, |
| 163 | { label: 'Labels', slug: 'guides/labels' }, | |
| 164 | { label: 'Milestones', slug: 'guides/milestones' }, | |
| Sidebar: the panels really slide | 165 | { label: 'The merge queue', slug: 'guides/merge-queue' }, |
| Merge rulesets: branch and tag rules, agent-first, enforced on push and merge | 166 | { label: 'Rules', slug: 'guides/rules' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 167 | { label: 'CODEOWNERS', slug: 'guides/codeowners' }, |
| Sidebar: the panels really slide | 168 | { label: 'Sessions and why-blame', slug: 'guides/why-blame' }, |
| 169 | { label: 'Forks and branches', slug: 'concepts/forks' }, | |
| 170 | ], | |
| 171 | }, | |
| 172 | { | |
| 173 | label: 'Workspaces', | |
| 174 | items: [ | |
| 175 | { label: 'Accounts and sign-in', slug: 'guides/authentication' }, | |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 176 | { label: 'GitHub', slug: 'guides/github' }, |
| Merge branch 'mirroring' into artifacts-mode | 177 | { label: 'Mirroring', slug: 'guides/mirroring' }, |
| Sidebar: the panels really slide | 178 | { label: 'Workspaces and tokens', slug: 'guides/workspaces' }, |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 179 | { label: 'Access and roles', slug: 'guides/access-and-roles' }, |
| Teams and CODEOWNERS, labels and milestones, dependency updates, the security suite, and a clearer top bar | 180 | { 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. | 181 | { label: 'People and teams', slug: 'guides/people-and-teams' }, |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 182 | { label: 'Managing a repository', slug: 'guides/managing-repositories' }, |
| Merge branch 'main' into worktree-agent-a69aeabc4b0deeb97 | 183 | { label: 'Releases', slug: 'guides/releases' }, |
| Invite-only launch: sign in with GitHub, repository access and lifecycle, many emails, a new look | 184 | { 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 API | 185 | { label: 'Audit log', slug: 'guides/audit-log' }, |
| Sidebar: the panels really slide | 186 | { label: 'Usage and billing', slug: 'guides/usage-and-billing' }, |
| 187 | { label: 'Git', slug: 'guides/git' }, | |
| 188 | ], | |
| 189 | }, | |
| 190 | { | |
| 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. | 191 | label: 'Run g1t yourself', |
| 192 | items: [ | |
| 193 | { label: 'With Docker Compose', slug: 'guides/self-hosting' }, | |
| 194 | { label: 'How a self-hosted g1t runs', slug: 'guides/self-hosting-architecture' }, | |
| 195 | { label: 'Deploy to Cloudflare', slug: 'guides/deploy-to-cloudflare' }, | |
| 196 | ], | |
| 197 | }, | |
| 198 | { | |
| Sidebar: the panels really slide | 199 | label: 'Reference', |
| 200 | items: [ | |
| 201 | { label: 'API overview', slug: 'reference/api' }, | |
| 202 | { label: 'MCP tools', slug: 'reference/mcp' }, | |
| Merge branch 'worktree-agent-a8752162fea25f63f' into spend-guardrails | 203 | { label: 'Rate limits', slug: 'reference/rate-limits' }, |
| Merge branch 'worktree-agent-ab2e39e11a6493412' | 204 | { label: 'Try it in the explorer', link: '/api/reference/', attrs: { target: '_self' } }, |
| Sidebar: the panels really slide | 205 | { label: 'OpenAPI document', link: 'https://api.g1t.sh/openapi.json' }, |
| 206 | { label: 'llms.txt', link: 'https://g1t.sh/llms.txt' }, | |
| 207 | ], | |
| 208 | }, | |
| Fast pages, required checks on the branch, self-hosted runners, honest incidents | 209 | { |
| 210 | label: 'About', | |
| What g1t can't do yet, and an open letter to Cloudflare | 211 | items: [ |
| 212 | { label: "What g1t can't do yet", slug: 'about/limitations' }, | |
| 213 | { label: 'An open letter to Cloudflare', slug: 'about/open-letter-to-cloudflare' }, | |
| 214 | ], | |
| Fast pages, required checks on the branch, self-hosted runners, honest incidents | 215 | }, |
| Merge branch 'worktree-agent-ab2e39e11a6493412' | 216 | ...apiGroups, |
| Sidebar: the panels really slide | 217 | ], |
| 218 | }), | |
| 219 | ], | |
| 220 | }); |
This file's history is long; its oldest lines are credited to the oldest commit read.