Skip to content

Where people and agents ship software together. The open-source git platform for the whole job: issues, agents, checks and deploys to the edge.

g1t.sh
522 linesCodeBlameRaw
1---
2title: What g1t can't do yet
3description: The limits you can hit on g1t today, why each one exists, what to do instead, and whether it is planned.
4---
5
6This page lists what g1t cannot do today. Each entry says what you can't
7do, why, what to do instead, and where it stands.
8
9Where it stands is one of:
10
11- **Planned**: we intend to build it. We don't give dates we can't keep.
12- **Depends on Cloudflare**: g1t runs on Cloudflare, and this needs
13 something the platform does not offer yet.
14- **Not scheduled**: no work is planned on it now.
15
16Several of these depend on Cloudflare; [we wrote to them about it](/about/open-letter-to-cloudflare/).
17
18If you hit a limit that is not here, tell us at
19[g1t.sh/support](https://g1t.sh/support), and we will add it.
20
21## Git
22
23### No git over SSH
24
25You can reach repositories only over HTTPS. A `git@g1t.sh:…` remote does
26not work.
27
28- **Why.** SSH needs inbound TCP connections on port 22. g1t runs on
29 Cloudflare Workers, which accept HTTP, not raw TCP. Cloudflare has a beta
30 for inbound TCP; we have applied and are waiting.
31- **Instead.** Use the HTTPS remote with an
32 [access token](/guides/git/#authentication). It does everything SSH would:
33 clone, fetch and push. SSH keys you add under **Settings → SSH keys** are
34 kept for when SSH arrives.
35- **Status.** Depends on Cloudflare. See [Git](/guides/git/#ssh).
36
37### Repositories up to 1 GB, files up to 32 MB, no LFS
38
39A repository can hold up to 1 GB and a single file up to 32 MB. Git LFS is
40not supported. A push that would cross either is declined before it is
41stored, and git prints why. See [Size limits](/guides/git/#size-limits).
42
43- **Why.** These are the limits of Cloudflare Artifacts, where every
44 repository is stored.
45- **Instead.** Keep large binaries out of the repository: in a release
46 bucket, a package registry or object storage, fetched at build time.
47- **Status.** Large file storage is planned. Raising the limits themselves
48 depends on Cloudflare.
49
50### Pushes up to 100 MB each
51
52A single push can carry up to 100 MB. A larger one is refused with HTTP
53`413` before g1t sees it.
54
55- **Why.** Cloudflare's network limits the size of one request body on the
56 plan g1t.sh is on.
57- **Instead.** Push history in steps, oldest first:
58 `git push origin <older-commit>:refs/heads/main`, then a newer one, then
59 `main`. Each push sends only what the last did not.
60- **Status.** Depends on Cloudflare.
61
62### Imports up to 40 MB
63
64Importing a repository copies it in one piece of at most 40 MB, after
65compression.
66
67- **Why.** The copy is held in memory while it moves, and a Worker has
68 128 MB for everything it is doing at once.
69- **Instead.** Clone the repository yourself and push it to g1t, in steps if
70 it is over 100 MB. See [Import a repository](/guides/github/#what-comes-across).
71- **Status.** Streaming the copy, so size stops mattering, is planned.
72
73### Partial clone works, but is not promised
74
75`git clone --filter=blob:none` returns a real partial clone today. We don't
76promise it will keep doing so.
77
78- **Why.** Cloudflare's documentation says filters are not supported, but
79 they work with git's protocol version 2. We have asked whether that is
80 intended.
81- **Instead.** Use it, and fall back to `--depth=1` for a shallow clone,
82 which is supported.
83- **Status.** Depends on Cloudflare.
84
85### No server-side hooks of your own
86
87You can't run a script of your own on g1t when a push arrives, before or
88after its refs move.
89
90- **Why.** The git store has no hook for this. g1t's own checks run in front
91 of it, in g1t's code: [protected branches](/guides/git/#protected-branches)
92 and [push protection](/guides/security/#push-protection).
93- **Instead.** Protect the default branch and make your workflows
94 [required checks](/guides/pull-requests/#required-status-checks). To react
95 after a push, use a [webhook](/guides/webhooks/) or a workflow on `push`.
96- **Status.** Not scheduled for your own scripts. A hook in the store,
97 which would let g1t enforce more before refs move, depends on Cloudflare.
98
99### Very large pushes are scanned after they land, not before
100
101A very large push is too large for push protection to read before it is
102stored, so it is let through, and g1t scans every commit it added
103afterwards, in the background. A secret found that way is an open alert
104rather than a refused push, and the workspace's owners are emailed when one
105looks real. Most pushes are scanned before they land.
106
107- **Why.** Scanning reads the whole push inside a Worker, which has 128 MB
108 for everything it is doing at once. Past a certain size, scanning could fail
109 the push outright, and refusing such pushes would block importing real
110 repositories.
111- **Instead.** To have a large history checked before it lands, push it in
112 steps (see above), so each push is scanned first. Secrets already in
113 history are listed under
114 [Secrets in history](/guides/security/#secrets-in-history).
115- **Status.** Planned: scanning while the push streams, at any size.
116
117### Deleting history does not free storage
118
119Storage is counted from what is pushed, and the count only grows. Deleting
120a branch, or force-pushing over commits, does not lower it.
121
122- **Why.** The git store does not say whether or when it reclaims space
123 from objects nothing points to any more, or report how much a repository
124 holds. So g1t cannot see it either.
125- **Instead.** Keep large mistakes out with a `.gitignore`. If one landed in
126 a private repository and counts against you, tell us at
127 [g1t.sh/support](https://g1t.sh/support).
128- **Status.** Depends on Cloudflare. See
129 [private repository storage](/guides/usage-and-billing/#private-repository-storage).
130
131## Pull requests and forks
132
133### Forks are only for pull requests
134
135You can't fork a repository into your own workspace. On g1t, a fork is a
136pull request's own working copy, made when the pull request is opened.
137
138- **Why.** We built forks to isolate agents' work, one per pull request.
139 See [Forks and branches](/concepts/forks/).
140- **Instead.** To contribute, open a pull request: it gets its own fork. To
141 start a copy of your own, clone the repository and push it to a new one
142 in your workspace; pushing creates it.
143- **Status.** Not scheduled.
144
145### Pull request forks are removed a day after they close
146
147A day after a pull request merges or closes, its fork's git data is
148removed. The pull request's changes stay readable: its head is kept in the
149repository as `refs/pull/<pull request id>/head`. Pushing to the fork, or
150reopening the pull request, makes the fork again from there.
151
152- **Why.** Cloudflare has not documented whether a fork shares stored
153 objects with its source or copies them, so forks are not kept longer
154 than they are useful.
155- **Instead.** Nothing you need to do. To keep working on a closed pull
156 request's change, fetch `refs/pull/<pull request id>/head` and push it
157 to a branch.
158- **Status.** Clear fork storage rules depend on Cloudflare.
159
160### Some dependency update options are not applied yet
161
162g1t reads and checks every option of a `dependabot.yml` file, but does not
163act on all of them yet:
164
165- Version update pull requests are opened for npm, Cargo, Go and pip only.
166 Entries for other ecosystems are checked and listed, and open nothing.
167
168- A multi-ecosystem group opens one pull request per ecosystem, not one
169 for the group.
170- Registries that sign in with OIDC are not used.
171
172- **Instead.** Keep a separate entry per ecosystem and directory, and
173 check the Security page, which lists what each entry reads but does not
174 act on. See [Dependency updates](/guides/dependency-updates/#options).
175- **Status.** Planned.
176
177### No conflict resolution in the browser
178
179You can't resolve a merge conflict on the pull request's page.
180
181- **Instead.** Ask g1t to resolve it, or fix it on the command line.
182 See [Conflicts](/guides/pull-requests/#conflicts).
183- **Status.** Planned.
184
185## Actions and runners
186
187### Docker shares the job's network
188
189A job's Docker Engine runs its containers on the job's own network, not on
190networks of their own. A service is reached at `localhost` and by its
191name, as on GitHub, but two containers cannot listen on the same port, and
192`docker network create` gives no separation between containers.
193
194- **Why.** Jobs run in Cloudflare Containers, which let a container run
195 Docker but not route a container network of its own out, or change its
196 packet filter. Sharing the job's network is also what keeps the job's
197 guardrails on every container.
198- **Instead.** Give containers that would clash different ports.
199- **Status.** Not scheduled.
200
201### No `type=gha` build cache
202
203Buildx's GitHub Actions cache backend (`cache-to: type=gha`) is skipped on
204g1t, and the build runs without a cache.
205
206- **Why.** It talks to GitHub's cache service, which g1t's cache does not
207 speak yet.
208- **Instead.** Use a registry cache in g1t's container registry
209 (`type=registry`), or `type=local` with `actions/cache`. See
210 [caching image builds](/guides/actions/#caching-image-builds).
211- **Status.** Planned.
212
213### No multi-platform image builds on g1t's machines
214
215Building an image for another platform, such as `linux/arm64`, needs QEMU's
216emulators, which g1t's machines do not have set up.
217
218- **Instead.** Build other platforms on a
219 [self-hosted runner](/guides/self-hosted-runners/) of that architecture,
220 or one with QEMU set up.
221- **Status.** Planned.
222
223### Linux only on g1t's machines
224
225A job with `runs-on: windows-latest` or `macos-latest` fails on g1t's own
226machines.
227
228- **Instead.** [Self-hosted runners](/guides/self-hosted-runners/) run Linux,
229 macOS and Windows, on x64 and arm64.
230- **Status.** Not scheduled.
231
232### No background steps
233
234GitHub's background steps (`background: true` on a step, and `wait`,
235`wait-all`, `cancel` and `parallel` steps) are refused: a workflow with one
236does not run on g1t. A schedule's `timezone`, `concurrency.queue`,
237`cancel-timeout-minutes` and `snapshot` are read but not applied: schedules
238run in UTC, a concurrency group keeps one run waiting, a cancelled job stops
239in its usual time, and no runner image is made from a job. The workflow's
240page says so.
241
242- **Why.** They are newer than g1t's runner, which runs a job's steps one
243 after another.
244- **Instead.** Start a long-running process with `&` in a `run:` step and
245 stop it in a later one; write a schedule's `cron` in UTC.
246- **Status.** Not scheduled.
247
248### Self-hosted Windows and macOS jobs run on the host
249
250On a self-hosted runner, a job native to Windows or macOS runs directly on
251the machine, unsandboxed, in host mode, which is deprecated. Only Linux
252jobs run in a sandbox of their own, a container inside the runner's own
253container under Sysbox.
254
255- **Why.** Sandboxes for them are not built yet: Windows containers with
256 Hyper-V isolation, and ephemeral macOS virtual machines (two per Mac at
257 most, by Apple's licence).
258- **Instead.** Run Linux jobs in
259 [the runner's container](/guides/self-hosted-runners/#run-it-as-a-container),
260 and keep Windows and macOS runners for repositories whose code you
261 trust. Host mode refuses public repositories' work.
262- **Status.** Planned. See
263 [Windows and macOS](/guides/self-hosted-runners/#windows-and-macos).
264
265### A self-hosted job's Docker can reach its runner's container
266
267On a runner in its container under Sysbox, a job that uses Docker gets an
268engine of its own that is privileged inside the runner's container. It
269cannot reach the machine, but it can reach the runner's container,
270including the runner's credential.
271
272- **Instead.** Use ephemeral runners for code you do not trust, or
273 register with `--no-job-docker`.
274- **Status.** Not scheduled.
275
276### `actions/checkout` with Git LFS, or without git on a large repository
277
278`actions/checkout` is the action itself. With `lfs: true`, it finds no
279LFS files: g1t keeps none. In a job container whose image has no git, it
280downloads the commit as a tarball from
281`GET /repos/{owner}/{repo}/tarball/{ref}`, as on GitHub. g1t makes that
282tarball when it is asked, of up to 10,000 files and 24 MB, so the
283checkout of a larger repository fails there.
284
285- **Why.** The tarball is made in a Worker, which holds the files and the
286 archive in memory at once.
287- **Instead.** Keep large files out of Git LFS for now. For a large
288 repository, use an image with git, or install git in a step before the
289 checkout.
290- **Status.** Planned.
291
292### No `gh` command in jobs
293
294The runner does not include the `gh` command, and pointing it at g1t
295(`GH_HOST=g1t.sh`) does not work.
296
297- **Why.** Most of `gh`'s commands use a GraphQL API, and the rest expect
298 the REST API under `/api/v3` on the same host. g1t's API is REST, at
299 `api.g1t.sh`.
300- **Instead.** Call the API with `curl` and the job's token. See
301 [calling g1t's API from a job](/guides/actions/#calling-g1ts-api-from-a-job).
302- **Status.** Not scheduled.
303
304### One Ruby for `ruby/setup-ruby`
305
306On g1t's machines, `ruby/setup-ruby` finds Ruby 3.3, which the runner
307includes, and fails for any other version.
308
309- **Why.** Its prebuilt Rubies are for other Linux systems, so on Debian it
310 uses only the Rubies already in `RUNNER_TOOL_CACHE`.
311- **Instead.** Use 3.3, run the job in a `container:` with the Ruby you
312 need (such as `ruby:3.4`), or build it in a step with `ruby-build`. See
313 [languages and their setup actions](/guides/actions/#languages-and-their-setup-actions).
314- **Status.** Not scheduled.
315
316### Machine sizes, time and storage
317
318| Limit | Value |
319| --- | --- |
320| Largest machine | 4 vCPUs, 12 GiB of memory, 20 GB of disk (`g1t-4core`). No GPUs. |
321| One job on g1t's machines | 60 minutes. On a self-hosted runner, 24 hours. |
322| One cache entry | 2 GiB, compressed. A larger one is not saved. |
323| A repository's caches | 10 GiB together. Past it, the entries restored longest ago are removed. |
324| One artifact | 5 GiB, zipped. Kept 14 days unless the repository says otherwise, at most 90. |
325| A run's artifacts | 10 GiB together. |
326
327The machine sizes are Cloudflare Containers' instance sizes. For more, use a
328[self-hosted runner](/guides/self-hosted-runners/). See
329[Machine sizes](/guides/actions/#machine-sizes) and [the cache](/guides/actions/#the-cache).
330
331### Workflow features not supported yet
332
333- Actions that upload or download artifacts with the toolkit's artifact
334 library themselves. The library refuses to run against any server but
335 github.com. `actions/upload-artifact`, `actions/download-artifact` and
336 `actions/upload-artifact/merge` work, as g1t runs them itself.
337- A cache entry between 100 and 128 MB saved by `actions/cache` or another
338 action built on the toolkit, such as `setup-node` with `cache: npm`. The toolkit sends an
339 entry under 128 MB in one request, and g1t takes at most 100 MB in one
340 request, as for [pushes](#pushes-up-to-100-mb-each). The step warns and
341 the job goes on; smaller and larger entries are saved.
342- `on: label`: creating, editing or deleting a label starts no workflows.
343 Putting a label on an issue or a pull request starts `issues` and
344 `pull_request` workflows with the `labeled` type.
345- The `pull_request` activity types `unassigned`, `locked`, `unlocked`,
346 and `edited` for a new title or description, and the `issues` types
347 `unassigned`, `locked`, `unlocked`, `pinned` and `unpinned`: g1t starts
348 no workflows for them.
349
350See [Not yet](/guides/actions/#not-yet). **Status.** Planned.
351
352### No npm trusted publishing or provenance
353
354A workflow on g1t can't publish to npm with trusted publishing, or with
355`--provenance`.
356
357- **Why.** Both trade the job's OIDC token with npm and Sigstore, which
358 accept tokens only from the CI services they list. g1t's
359 [OIDC tokens](/guides/actions/#oidc-tokens) work with any cloud that
360 lets you add an issuer, and npm does not.
361- **Instead.** Publish with a granular access token in a secret
362 (`NODE_AUTH_TOKEN`); see [npm](/guides/actions/#npm).
363- **Status.** Depends on npm.
364
365## Deployments
366
367### Containers are not switched on yet
368
369[Docker deployments](/guides/deployments/#docker-deployments) are built,
370but off on g1t.page: a project that runs as a container fails to deploy,
371saying so, and one with a site besides its `Dockerfile` is built as that
372site.
373
374- **Why.** Cloudflare's container APIs (applications in a Workers for
375 Platforms namespace, registry logins) have to be checked against g1t's
376 own account first.
377- **Instead.** Build a framework app as a static export or with its
378 Cloudflare adapter, as [Frameworks](/guides/deployments/#frameworks)
379 lists, or set **Build as** to Static site. Or deploy the server from a
380 workflow to wherever it runs today, with its credentials in
381 [secrets](/guides/secrets-and-variables/).
382
383### A container is one instance, and keeps nothing
384
385A container app runs one instance at a time, sleeps after five minutes
386without a request, and starts from its image each time it wakes.
387
388- **Why.** Each app's container is one Durable Object's, and Cloudflare
389 Containers' disks last only as long as the container runs.
390- **Instead.** Keep data in a database or a bucket the app reaches over
391 the network. A larger **Container size** gives one instance more room.
392
393### What a container sends out is not counted
394
395The data a container sends back to visitors is metered; what it sends to
396other hosts on the internet (a database elsewhere, an API) is not.
397
398- **Why.** It leaves the container without passing through g1t.
399- **Instead.** Nothing to do: it is not charged.
400- **Status.** A runtime for servers is planned.
401
402### Some Workers bindings are not provisioned
403
404A Workers project deploys without D1, KV, R2, Durable Objects, Queues,
405service bindings, Vectorize, Hyperdrive, Workers AI or Workflows, and its
406cron triggers are not scheduled.
407
408- **Why.** Each of these is a resource g1t has to create and bill per
409 project, and that is not built yet.
410- **Instead.** Check that a binding exists before using it. The deployment
411 lists each binding it left out, and warns when its cron triggers will
412 not run.
413- **Status.** Planned. See [Workers projects](/guides/deployments/#workers-projects).
414
415### Build and size limits
416
417A build stops after 45 minutes. A static site can have up to 20,000 files
418and 25 MiB per file, which are Cloudflare's limits. See
419[Static sites](/guides/deployments/#static-sites).
420
421## Data residency
422
423You can't choose where a workspace's data is stored. g1t's databases keep
424their primary copy in the United States, with read copies in other regions
425so pages load fast. Repositories are not pinned to a region.
426
427- **Why.** Cloudflare fixes the region of a repository store when it is
428 created, and g1t has one store so far.
429- **Instead.** None today, if your data must stay in the EU.
430- **Status.** EU residency, with an EU-only repository store and databases,
431 is planned.
432
433## Billing
434
435### Some costs are not fully defined yet
436
437Cloudflare starts billing for Artifacts, where repositories are stored, on
438October 14, 2026, and has not yet said exactly which calls count as a
439billable operation.
440
441- **What g1t does.** It counts every clone, fetch and push through its git
442 endpoints. Each day it checks what Cloudflare billed it for containers and
443 apps against what was used. When a cost moves,
444 g1t's price moves with it, and every change is listed with its reason on
445 [g1t.sh/pricing](https://g1t.sh/pricing).
446- **What this means for you.** Prices can change while Cloudflare's beta
447 products settle. They follow cost.
448 See [How prices are set](/guides/usage-and-billing/#how-prices-are-set)
449 and [git operations](/guides/usage-and-billing/#git-operations).
450- **Status.** Depends on Cloudflare.
451
452### Payments are in test mode
453
454While payments are in test mode, no real card is charged, so a card check
455proves nothing. g1t's hosted models are open only to a few invited
456workspaces, g1t's own among them. Every other workspace, trial or not,
457runs its agents on its own model provider; without one, assigning an agent
458is refused with a message that says so.
459
460- **Instead.** Connect your own [model provider](/guides/models/). Your
461 agents then run on your keys, and the provider bills you directly.
462- **Status.** Planned: hosted models for every workspace once payments go
463 live.
464
465## Agents
466
467### Confidence is a judgement, not a guarantee
468
469The confidence g1t gives an agent's change, high, medium or low, is
470worked out from what g1t can observe: checks, reviews, revisions, the size
471and reach of the change. It cannot tell whether the change is correct.
472
473- **Instead.** Keep **Ask a person before merging low-confidence changes**
474 on, and make your workflows required checks. A high rating on a
475 repository with weak tests means less. See
476 [How sure the agent is](/guides/working-with-g1t/#how-sure-the-agent-is).
477- **Status.** The signals and their weights may change as we learn from
478 real changes.
479
480### Agents' model calls go through g1t
481
482An agent's model requests always pass through g1t's model proxy,
483`models.g1t.sh`, with your keys or g1t's. You can't point an agent's sandbox
484straight at a provider.
485
486- **Why.** So that no key is ever inside a sandbox, and so budgets, caps and
487 the audit log hold. See [Your keys never reach a sandbox](/guides/models/#your-keys-never-reach-a-sandbox).
488- **Status.** Not planned. This is by design.
489
490## Accounts, status and self-hosting
491
492### Tokens for one workspace you belong to
493
494A personal access token can be made for one workspace only when you are a
495member of it. For a repository where you are an outside collaborator, make
496a token for all your workspaces. A workspace's
497[rules for tokens](/guides/authentication/#a-workspaces-rules-for-tokens)
498cover personal access tokens only, not applications you signed in to with
499OAuth. **Status.** Planned.
500
501### No uptime commitment during the beta
502
503g1t does not promise a particular uptime or offer a service level agreement
504unless you have a written agreement with us. Several of the Cloudflare
505products g1t is built on are in beta and have none either.
506[status.g1t.sh](https://status.g1t.sh/) shows how each part of g1t is doing,
507and every incident. Sandboxes are not checked there yet. See
508[Status and incidents](/guides/status/). **Status.** Not scheduled during
509the beta.
510
511### Self-hosting is early
512
513[Running g1t yourself](/guides/self-hosting/) gives you the core forge:
514accounts, repositories over HTTP, issues and pull requests. g1t's agent,
515Actions, deployments, git over SSH, the REST API and MCP are off, and it is
516not ready for the open internet. **Status.** Planned, in phases.
517
518### Not built yet
519
520
521- **Releases and package registries.** Planned.
522- **Wikis.** Not scheduled. Keep docs in the repository.