Skip to content
220 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.

Agents move along on private repositories too1# g1t
2
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.3g1t is where a company's people and agents work together. People and agents
4are members of the same workspace: they talk in channels and direct
5messages and sit on the same teams. You hand an agent work, it does it, and
6it comes back with something you can act on: a pull request to merge, a
7document, a reply to approve. Today says what happened and what is waiting
8on you. Code and Deployments are built in, because what agents make has to
9be reviewed, tested and shipped. Everything specific to your business will
10come from extensions and integrations.
11
12g1t is MIT-licensed. Use it on [g1t.sh](https://g1t.sh), or run it
13yourself. It runs on Cloudflare Workers, and the core runs in Docker.
Agents move along on private repositories too14
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**g1t is in alpha.** Accounts are by invite. Each feature below is marked:
Chat and workspace agents: channels, DMs and named agents you talk to16
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.17- **Live**: works on g1t.sh for every workspace.
18- **Preview**: works on g1t.sh, but is limited to some workspaces or
19 unfinished.
20- **Coming**: planned, not built.
Agents move along on private repositories too21
22## Where things are
23
24- Site: <https://g1t.sh>
25- Docs: <https://docs.g1t.sh>
26- API: <https://api.g1t.sh> · MCP: <https://mcp.g1t.sh>
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.27- Limits you can hit today: [docs.g1t.sh/about/limitations](https://docs.g1t.sh/about/limitations/)
Agents move along on private repositories too28
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.29## What's in it
Agents move along on private repositories too30
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.31### The workspace
Agents move along on private repositories too32
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.33| Feature | Status |
34| --- | --- |
35| The dock: Today, Chat, Notifications, Agents, Code, Artifacts and your pinned apps, with People, Workspace and your account at its foot; a bottom bar on phones | Live |
36| Today: what agents finished, how much was accepted the first time, what's waiting on you, what was spent, and where to start | Preview |
37| Chat: channels, direct messages and threads, live, with people and agents as members | Live |
38| Notifications: mentions, reviews, approvals and alerts, with browser push | Live |
39| People and teams: members, roles, nested teams, invites | Live |
40| A directory of people and agents, profiles, org chart, teams with agent members | Coming |
41| Artifacts: documents written together, live, by people and agents | Live |
42| Slides, designs and dashboards as artifacts | Coming |
43| Scratchpads: tools, reports and agents anyone can build on a copy of the data, promoted after review | Coming |
44| Desktop app (Tauri, with a runner inside) and phone app (Expo) | Coming |
Agents move along on private repositories too45
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.46### Agents
Agents move along on private repositories too47
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.48| Feature | Status |
49| --- | --- |
50| Agents hired into roles from templates, each with responsibilities, a voice, model limits and a budget | Live |
51| `@g1t`, the orchestrator every workspace has, which hands work to the right agent with `hand_off` | Live |
52| Your own model providers' keys (14 providers), and the AI Gateway | Live |
53| g1t's hosted models (open to invited workspaces during the alpha) | Preview |
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.54| Budgets per workspace, person, agent and task; guardrails; agents act with the asker's access | Live |
55| Spend: where the money went by agent, person, channel, model and product, every budget, a receipt for each task, and your spend in the top bar | Preview |
56| Spend by extension | Coming |
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.57| Memory, sessions with live steps and cost, routines on a schedule | Live |
The Marketplace adds what g1t doesn't do and connects what you already use: extensions (Mail, Support, CRM, Recruiting, On-call, and bridges to a helpdesk, CRM or ERP you run, all Soon), starter kits, and integrations connected by the workspace or by each person; agents aren't installed there. Agent templates live in Agents, as starting points you configure, at Agents → Templates, and the Marketplace's old agent addresses lead there. The marketplace and agents guides say how.58| Agent templates in Agents: starting points for a new agent, configured once started | Live |
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.59| Foundational skills in every agent: PDFs, Word documents and spreadsheets, reports with sources, charts, code review, thread summaries; owners turn them off per agent | Live |
The Marketplace adds what g1t doesn't do and connects what you already use: extensions (Mail, Support, CRM, Recruiting, On-call, and bridges to a helpdesk, CRM or ERP you run, all Soon), starter kits, and integrations connected by the workspace or by each person; agents aren't installed there. Agent templates live in Agents, as starting points you configure, at Agents → Templates, and the Marketplace's old agent addresses lead there. The marketplace and agents guides say how.60| More specialist templates; web research; skills you write, add from the Marketplace or learn from work | Coming |
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.61| Agents on runners anywhere (g1t's, yours, your desktop), with sessions that persist between tasks | Coming |
62| Agents answering in Slack and Teams | Coming |
63
64### Code and Deployments
65
66| Feature | Status |
67| --- | --- |
68| Public and private repositories, git over HTTPS, creating a repository by pushing to it | Live |
69| Issues, pull requests, line comments, reviews from people and agents | Live |
70| Required checks, rulesets, CODEOWNERS, the merge queue | Live |
71| Workflows from `.g1t/workflows` on g1t's runners or self-hosted ones (`crates/runner`) | Live |
72| Assign an issue to g1t: a pull request, checks, a review and revisions until it passes (invited workspaces) | Preview |
73| Any coding agent over MCP, recording its session onto its pull requests; why-blame | Live |
74| Packages: npm, Cargo, Composer, Maven, NuGet, RubyGems, Go modules, container images | Live |
75| Secret push protection, history scanning, dependency upgrade pull requests | Live |
76| A preview of every pull request on `g1t.page`, production on merge, custom domains | Live |
77| GitHub import, mirroring and pushing back | Live |
78| A copy of the data for every preview, instant rollback, container apps kept warm | Coming |
79| Git over SSH (waits on inbound TCP on Workers; use HTTPS) | Coming |
80
81### Extend and run
82
83| Feature | Status |
84| --- | --- |
85| Integrations: the GitHub App, Sentry, Datadog, Jira, Linear, alerts | Live |
86| REST API, OpenAPI, MCP server, webhooks, an event bus | Live |
87| Usage billing with no seats, a public price book, spend limits, itemised invoices | Live |
The Marketplace adds what g1t doesn't do and connects what you already use: extensions (Mail, Support, CRM, Recruiting, On-call, and bridges to a helpdesk, CRM or ERP you run, all Soon), starter kits, and integrations connected by the workspace or by each person; agents aren't installed there. Agent templates live in Agents, as starting points you configure, at Agents → Templates, and the Marketplace's old agent addresses lead there. The marketplace and agents guides say how.88| The Marketplace: extensions and integrations, added by owners, with install requests from members | Live |
89| Extensions shared from public repositories (Mail, Support, CRM, Recruiting, On-call and helpdesk, CRM and ERP bridges are listed); Drive, Gmail, Calendar and Slack integrations | Coming |
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.90| Single sign-on (SAML, OIDC) and SCIM per workspace | Coming |
91| Storage: databases and buckets per team, with copies of production for anything unreviewed | Coming |
92| Self-hosting: the core forge in Docker Compose (agents, deployments and context search off) | Preview |
93
Agents move along on private repositories too94## Try it
95
96```sh
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.97# 1. Create an account and a workspace at https://g1t.sh/register (you need an invite).
Agents move along on private repositories too98
99# 2. Connect Claude Code, then run /mcp in it to sign in through your browser.
100claude mcp add --transport http g1t https://mcp.g1t.sh
101
102# 3. Ask it to open a pull request for an open issue.
103```
104
105[Getting started](https://docs.g1t.sh/quickstart/) walks through this in
106full. An assistant can do it for you from <https://g1t.sh/llms.txt>.
107
108## Layout
109
README: the layout table gives each part's language in its own column110| Path | What it is | Language |
111| --- | --- | --- |
112| `apps/web` | The site: server-rendered React on a Worker. Holds no data. | TypeScript |
113| `apps/docs` | The documentation site, with the API explorer. | TypeScript |
114| `apps/api` | REST API and MCP server. | Rust |
115| `services/identity` | Accounts, workspaces, sessions, keys and tokens. | Rust |
116| `services/repos` | Repository registry, contents, forks, diffs, landing, git over HTTPS. | Rust |
117| `services/work` | Issues, pull requests, reviews, check runs and sessions. | Rust |
118| `services/events` | The event bus and its log. | Rust |
119| `services/search` | Site-wide search and Explore. | Rust |
120| `services/billing` | Usage, the price book, limits, invoices and payments. | Rust |
121| `services/actions` | GitHub Actions workflows, runs, caches and self-hosted runners. | Rust |
122| `services/security` | Push protection findings, history scanning and dependency upkeep. | Rust |
123| `services/integrations` | Model providers, alerts, trackers and the GitHub App. | Rust |
124| `services/webhooks` | Webhook deliveries. | Rust |
125| `services/runner` | Starts sandboxes: for g1t agents, workflow jobs and the merge queue. | TypeScript |
Projects no longer depend on each other: the dependsOn relation, its settings page (old links redirect), the overview card, a pull request's Affects panel and preview stacks, reference variables and agents' notes on what a project uses are gone; the table is dropped in a later deploy126| `services/projects` | Projects: what a workspace builds and runs, and where its code lives. | TypeScript |
README: the layout table gives each part's language in its own column127| `services/deployments` | Builds, previews and production on `g1t.page`. | TypeScript |
128| `services/pages` | Serves every app deployed on `g1t.page`, and custom domains. | TypeScript |
129| `services/models` | The model proxy at `models.g1t.sh`. | TypeScript |
130| `services/context` | The context hub: catalog, search and scorecards. | TypeScript |
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.131| `services/chat` | Channels, direct messages, threads and their live sockets. | TypeScript |
132| `services/agents` | The workspace's agents: definitions, templates, desks, memory and runs. | TypeScript |
133| `services/docs` | Artifacts: documents, their spaces, sharing and live editing. | TypeScript |
134| `services/notify` | Notifications: each person's feed, live counts and browser push. | TypeScript |
135| `services/packages` | The package registries and container images. | Rust |
README: the layout table gives each part's language in its own column136| `services/og` | Social cards at `og.g1t.sh`: a PNG per page, showing only what anyone may see. | TypeScript |
137| `apps/status` | The status page at `status.g1t.sh`. | TypeScript |
138| `apps/sudo` | g1t's own staff console. | TypeScript |
139| `crates/runner` | The program inside a sandbox: runs an agent, a workflow job or a merge queue build, and reports back. | Rust |
140| `crates/contracts` | Types and service interfaces for the Rust services. | Rust |
141| `crates/kit` | Plumbing shared by Rust services on Workers. | Rust |
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.142| `crates/g1t` | The `g1t` command line. | Rust |
143| `crates/rules` | The rules engine for rulesets on branches and tags. | Rust |
144| `crates/blobstore` | Object storage: R2 on Cloudflare, any S3-compatible store self-hosted. | Rust |
README: the layout table gives each part's language in its own column145| `crates/actions` | Reads workflows and evaluates their expressions. | Rust |
146| `crates/scan` | Secret and lockfile scanning, shared by services. | Rust |
147| `crates/secrets` | Secrets at rest and signatures. | Rust |
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.148| `crates/sshd` | Git over SSH, bridged to Cloudflare Artifacts. Not deployed yet. | Rust |
README: the layout table gives each part's language in its own column149| `packages/contracts` | The same interfaces for TypeScript callers. | TypeScript |
150| `packages/theme` | Design tokens and the logo, shared by the site and the docs. | CSS |
151| `deploy` | `stack.jsonc`, every deployable part and its resources; `self-host`, the Docker Compose version. | JSON, Docker Compose |
Agents move along on private repositories too152
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily153Each service is its own Worker, and each one that keeps data has its own
154database. They call each other through service bindings and react to each
155other through events. The core services (accounts, repositories, work,
156events, billing, Actions, security and the API) are written in Rust; the
README: the layout table gives each part's language in its own column157web apps and the rest of the Workers in TypeScript. The Language column
158says which, part by part.
Agents move along on private repositories too159
160## Run your own
161
README: run the core forge locally with Docker Compose; forks described as copies, not copy-on-write, until Cloudflare says otherwise162### On your own machine
163
164The core forge runs in Docker, with no Cloudflare account:
165
166```sh
167docker compose -f deploy/self-host/docker-compose.yml up --build
168```
169
170Then open http://localhost:8787 and sign up. The confirmation mail is in
Merge branch 'worktree-agent-aaf03bdceac799c89'171Mailpit at http://localhost:8025. Repositories, push and clone, issues,
172pull requests and code browsing work, and the API and MCP server answer at
Merge branch 'worktree-agent-af58ac8933b0dd125'173http://localhost:8789; packages and container images are kept in the
174bundled S3-compatible store, RustFS. Agents, deployments and context search
175are off in this version.
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.176[Run g1t yourself](https://docs.g1t.sh/guides/self-hosting/) says what works,
177and [how a self-hosted g1t runs](https://docs.g1t.sh/guides/self-hosting-architecture/)
178what runs inside it.
README: run the core forge locally with Docker Compose; forks described as copies, not copy-on-write, until Cloudflare says otherwise179
180### On Cloudflare
181
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.182You need a Cloudflare account on the Workers Paid plan (Cloudflare
183Artifacts, where repositories are stored, requires it), Node 22.22 or newer (`engines` in `package.json`; g1t is built on
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily184Node 24), Rust with the `wasm32-unknown-unknown` target, and
Agents move along on private repositories too185Docker to build the sandbox image.
186
187```sh
188npm install
189npx wrangler login
190```
191
192Then, once:
193
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily1941. Create the resources each part needs: D1 databases, queues, KV
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.195 namespaces, R2 buckets and the Cloudflare Artifacts namespace (`npx wrangler d1
Git storage hardened, pages in tens of milliseconds, honest security alerts, and costs reconciled daily196 create <name>`, `npx wrangler queues create <name>`, and so on), and set
197 each part's secrets. `deploy/stack.jsonc` lists them all.
Agents move along on private repositories too1982. Put your own `account_id`, database ids and hostnames in each
199 `wrangler.jsonc`.
Deploy scripts live in the repository2003. For [Deployments](https://docs.g1t.sh/guides/deployments/), which needs
201 the Workers for Platforms add-on and a zone for apps:
202 `scripts/setup-deployments.sh`.
Agents move along on private repositories too203
Deploy scripts live in the repository204Deploy everything, migrations first, in dependency order:
Agents move along on private repositories too205
206```sh
Deploy scripts live in the repository207scripts/deploy.sh
Agents move along on private repositories too208```
209
Deploy scripts live in the repository210Or only what changed, still in order: `scripts/deploy.sh billing web`.
211Both use your `wrangler login`, not a token in `.env`.
212
Agents move along on private repositories too213Create the first account by registering on your site, or with
214`node services/identity/scripts/create-user.mjs <username>`.
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.215[Deploy g1t to Cloudflare](https://docs.g1t.sh/guides/deploy-to-cloudflare/)
216covers the deploy tool, the workflow and first-time setup in full.
Agents move along on private repositories too217
218## License
219
220[MIT](LICENSE)

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