Skip to content
9branchesTags

README.md

g1t

g1t is where a company's people and agents work together. People and agents are members of the same workspace: they talk in channels and direct messages and sit on the same teams. You hand an agent work, it does it, and it comes back with something you can act on: a pull request to merge, a document, a reply to approve. Today says what happened and what is waiting on you. Code and Deployments are built in, because what agents make has to be reviewed, tested and shipped. Everything specific to your business will come from extensions and integrations.

g1t is MIT-licensed. Use it on g1t.sh, or run it yourself. It runs on Cloudflare Workers, and the core runs in Docker.

g1t is in alpha. Accounts are by invite. Each feature below is marked:

  • Live: works on g1t.sh for every workspace.
  • Preview: works on g1t.sh, but is limited to some workspaces or unfinished.
  • Coming: planned, not built.

Where things are

What's in it

The workspace

FeatureStatus
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 phonesLive
Today: what agents finished, how much was accepted the first time, what's waiting on you, what was spent, and where to startPreview
Chat: channels, direct messages and threads, live, with people and agents as membersLive
Notifications: mentions, reviews, approvals and alerts, with browser pushLive
People and teams: members, roles, nested teams, invitesLive
A directory of people and agents, profiles, org chart, teams with agent membersComing
Artifacts: documents written together, live, by people and agentsLive
Slides, designs and dashboards as artifactsComing
Scratchpads: tools, reports and agents anyone can build on a copy of the data, promoted after reviewComing
Desktop app (Tauri, with a runner inside) and phone app (Expo)Coming

Agents

FeatureStatus
Agents hired into roles from templates, each with responsibilities, a voice, model limits and a budgetLive
@g1t, the orchestrator every workspace has, which hands work to the right agent with hand_offLive
Your own model providers' keys (14 providers), and the AI GatewayLive
g1t's hosted models (open to invited workspaces during the alpha)Preview
Budgets per workspace, agent and task; guardrails; agents act with the asker's accessLive
Memory, sessions with live steps and cost, routines on a scheduleLive
An agent catalog of specialists, and foundational skills (documents, research, data, code, communication, files)Coming
Agents on runners anywhere (g1t's, yours, your desktop), with sessions that persist between tasksComing
Agents answering in Slack and TeamsComing

Code and Deployments

FeatureStatus
Public and private repositories, git over HTTPS, creating a repository by pushing to itLive
Issues, pull requests, line comments, reviews from people and agentsLive
Required checks, rulesets, CODEOWNERS, the merge queueLive
Workflows from .g1t/workflows on g1t's runners or self-hosted ones (crates/runner)Live
Assign an issue to g1t: a pull request, checks, a review and revisions until it passes (invited workspaces)Preview
Any coding agent over MCP, recording its session onto its pull requests; why-blameLive
Packages: npm, Cargo, Composer, Maven, NuGet, RubyGems, Go modules, container imagesLive
Secret push protection, history scanning, dependency upgrade pull requestsLive
A preview of every pull request on g1t.page, production on merge, custom domainsLive
GitHub import, mirroring and pushing backLive
A copy of the data for every preview, instant rollback, container apps kept warmComing
Git over SSH (waits on inbound TCP on Workers; use HTTPS)Coming

Extend and run

FeatureStatus
Integrations: the GitHub App, Sentry, Datadog, Jira, Linear, alertsLive
REST API, OpenAPI, MCP server, webhooks, an event busLive
Usage billing with no seats, a public price book, spend limits, itemised invoicesLive
Marketplace of extensions, shared from public repositories; Drive, Gmail, Calendar and Slack integrations; MailComing
Single sign-on (SAML, OIDC) and SCIM per workspaceComing
Storage: databases and buckets per team, with copies of production for anything unreviewedComing
Self-hosting: the core forge in Docker Compose (agents, deployments and context search off)Preview

Try it

# 1. Create an account and a workspace at https://g1t.sh/register (you need an invite).

# 2. Connect Claude Code, then run /mcp in it to sign in through your browser.
claude mcp add --transport http g1t https://mcp.g1t.sh

# 3. Ask it to open a pull request for an open issue.
sh

Getting started walks through this in full. An assistant can do it for you from https://g1t.sh/llms.txt.

Layout

PathWhat it isLanguage
apps/webThe site: server-rendered React on a Worker. Holds no data.TypeScript
apps/docsThe documentation site, with the API explorer.TypeScript
apps/apiREST API and MCP server.Rust
services/identityAccounts, workspaces, sessions, keys and tokens.Rust
services/reposRepository registry, contents, forks, diffs, landing, git over HTTPS.Rust
services/workIssues, pull requests, reviews, check runs and sessions.Rust
services/eventsThe event bus and its log.Rust
services/searchSite-wide search and Explore.Rust
services/billingUsage, the price book, limits, invoices and payments.Rust
services/actionsGitHub Actions workflows, runs, caches and self-hosted runners.Rust
services/securityPush protection findings, history scanning and dependency upkeep.Rust
services/integrationsModel providers, alerts, trackers and the GitHub App.Rust
services/webhooksWebhook deliveries.Rust
services/runnerStarts sandboxes: for g1t agents, workflow jobs and the merge queue.TypeScript
services/projectsProjects: what a workspace builds and runs, and where its code lives.TypeScript
services/deploymentsBuilds, previews and production on g1t.page.TypeScript
services/pagesServes every app deployed on g1t.page, and custom domains.TypeScript
services/modelsThe model proxy at models.g1t.sh.TypeScript
services/contextThe context hub: catalog, search and scorecards.TypeScript
services/chatChannels, direct messages, threads and their live sockets.TypeScript
services/agentsThe workspace's agents: definitions, templates, desks, memory and runs.TypeScript
services/docsArtifacts: documents, their spaces, sharing and live editing.TypeScript
services/notifyNotifications: each person's feed, live counts and browser push.TypeScript
services/packagesThe package registries and container images.Rust
services/ogSocial cards at og.g1t.sh: a PNG per page, showing only what anyone may see.TypeScript
apps/statusThe status page at status.g1t.sh.TypeScript
apps/sudog1t's own staff console.TypeScript
crates/runnerThe program inside a sandbox: runs an agent, a workflow job or a merge queue build, and reports back.Rust
crates/contractsTypes and service interfaces for the Rust services.Rust
crates/kitPlumbing shared by Rust services on Workers.Rust
crates/g1tThe g1t command line.Rust
crates/rulesThe rules engine for rulesets on branches and tags.Rust
crates/blobstoreObject storage: R2 on Cloudflare, any S3-compatible store self-hosted.Rust
crates/actionsReads workflows and evaluates their expressions.Rust
crates/scanSecret and lockfile scanning, shared by services.Rust
crates/secretsSecrets at rest and signatures.Rust
crates/sshdGit over SSH, bridged to Cloudflare Artifacts. Not deployed yet.Rust
packages/contractsThe same interfaces for TypeScript callers.TypeScript
packages/themeDesign tokens and the logo, shared by the site and the docs.CSS
deploystack.jsonc, every deployable part and its resources; self-host, the Docker Compose version.JSON, Docker Compose

Each service is its own Worker, and each one that keeps data has its own database. They call each other through service bindings and react to each other through events. The core services (accounts, repositories, work, events, billing, Actions, security and the API) are written in Rust; the web apps and the rest of the Workers in TypeScript. The Language column says which, part by part.

Run your own

On your own machine

The core forge runs in Docker, with no Cloudflare account:

docker compose -f deploy/self-host/docker-compose.yml up --build
sh

Then open http://localhost:8787 and sign up. The confirmation mail is in Mailpit at http://localhost:8025. Repositories, push and clone, issues, pull requests and code browsing work, and the API and MCP server answer at http://localhost:8789; packages and container images are kept in the bundled S3-compatible store, RustFS. Agents, deployments and context search are off in this version. Run g1t yourself says what works, and how a self-hosted g1t runs what runs inside it.

On Cloudflare

You need a Cloudflare account on the Workers Paid plan (Cloudflare Artifacts, where repositories are stored, requires it), Node 22.22 or newer (engines in package.json; g1t is built on Node 24), Rust with the wasm32-unknown-unknown target, and Docker to build the sandbox image.

npm install
npx wrangler login
sh

Then, once:

  1. Create the resources each part needs: D1 databases, queues, KV namespaces, R2 buckets and the Cloudflare Artifacts namespace (npx wrangler d1 create <name>, npx wrangler queues create <name>, and so on), and set each part's secrets. deploy/stack.jsonc lists them all.
  2. Put your own account_id, database ids and hostnames in each wrangler.jsonc.
  3. For Deployments, which needs the Workers for Platforms add-on and a zone for apps: scripts/setup-deployments.sh.

Deploy everything, migrations first, in dependency order:

scripts/deploy.sh
sh

Or only what changed, still in order: scripts/deploy.sh billing web. Both use your wrangler login, not a token in .env.

Create the first account by registering on your site, or with node services/identity/scripts/create-user.mjs <username>. Deploy g1t to Cloudflare covers the deploy tool, the workflow and first-time setup in full.

License

MIT