Contents

gitta documentation

gitta coordinates AI coding agents that work in the same repository at the same time. It tells an agent when another agent changes code that its new work uses. It runs inside your normal git merge, tests the combined code before main moves and stops the merge when your tests fail. Removed tests and weakened security checks are reported in the merge output and the audit trail.

gitta runs on top of Git. It uses the normal git command, and your repository format, branches and pull requests stay as they are. It has no AI inside. It reads code with parsers, applies fixed rules and runs your own tests.

What gitta covers

Area	What you get	Read
Agents	Claude Code through hooks, Cursor and Codex through MCP, any tool that makes Git worktrees, and cloud agents that open pull requests	Agents
Warnings and sync	A warning at the agent's next step when another agent changes something its new code uses, and sync on request	Warnings and sync
Merging	Checks inside `git merge`, `git pull` and `git push`: weakened tests, credentials, security and your tests on the combined code	Merging
Watching	`gitta watch` in the terminal and `.gitta/gitta.log`	Watching gitta work
Security checks	Risky code in an agent's own lines, security controls one agent weakens while another relies on them, and, with gitta Enterprise, risky mainframe changes. Each finding is reported and recorded.	Security checks
Languages	Meaning analysis for the languages in the table below. Mainframe languages come with gitta Enterprise. All other files merge line by line and run through your tests.	Languages
Pull requests and CI	A check that compares each pull request with the other open ones, on GitHub and any CI, with GitLab and Azure Repos coming next	Pull requests, CI/CD
Audit	A hash-chained trail of every agent, warning, check and merge	Audit trail
Enterprise	A team server in your own cloud, so agents on different machines warn each other, with SSO, personal tokens and a team-wide audit trail	gitta Enterprise

Mainframe with gitta Enterprise

gitta Enterprise reads COBOL programs, copybooks and JCL. When one agent changes a copybook field, a paragraph or a program’s interface, every agent whose new code uses it is warned, and the pipeline check can stop a change before your DBB build. JCL, REXX, CLIST, COBOL and assembler changes that give code more authority are reported at merge time and in the audit trail. gitta runs next to the mainframe, on developer machines and CI runners. Nothing is installed on z/OS.

Mainframe guideSet up from zero, with where gitta runs, Git with EBCDIC, copybooks, CI and DBB. COBOL, copybooks and JCLWhat gitta follows, field by field. Mainframe security checksWhat gitta reports, and how to list your own libraries.

Where to start

InstallGet the gitta command for your platform. Quick startSet up a repository and see the first warning. How gitta worksWorkspaces, warnings, security checks, sync and the check inside git merge. Command referenceEvery command, option, file and setting.

Guides and answers

FAQShort answers on worktrees, other agent tools, code review and where your code goes. Stop agents overwriting each otherWorktrees for each agent, and warnings when their work meets. Parallel agent tools comparedConductor, Claude Squad and Vibe Kanban, and how gitta works with them. Review AI pull requestsA checklist for reviewers, and what gitta checks for you. Worktrees and agent conflictsWhy worktrees keep files apart but not meaning. COBOL modernisation with agentsSeveral agents on one COBOL code base.

By role

You are	Read
A developer who runs agents	Quick start, Agents, Warnings and sync, Merging
A team lead	What gitta watches and blocks, Pull requests and CI, Weakened checks, Audit trail
A mainframe team	Mainframe guide, COBOL, copybooks and JCL, Security checks on mainframe code
A platform or DevOps engineer	CI/CD integration, Team server, Kubernetes, Google Cloud, AWS and Azure, TLS
Security or compliance	Security and data, Security checks, Audit trail, Compliance, SBOM and CBOM, Tokens and sign-in

By platform

You work on	Read
macOS	Install script or Homebrew
Linux	Install script, Linux workspaces and the sandbox
z/OS	Where gitta runs, Git and EBCDIC, CI and DBB
Windows	PowerShell install script
Kubernetes, Docker and clouds	Kubernetes, Docker, Google Cloud, AWS and Azure

Free and Enterprise

The gitta command is free and open source. It covers everything on one machine, including workspaces, warnings, sync, the merge check, the security checks, the pull request check and the local audit trail.

gitta Enterprise adds a team server. Agents on different laptops, CI runners and cloud agents then warn each other too. Enterprise also adds mainframe support for COBOL, copybooks, JCL and code pages, personal tokens, SSO, a team-wide audit trail and deployments for Kubernetes, Google Cloud, AWS and Azure. The server runs in your own account.

Supported platforms

The short version is below. See Supported platforms for the full list.

Platform	Status
macOS (Apple silicon and Intel)	Supported
Linux (x86_64 and arm64)	Supported. Shared copy-on-write workspaces and the agent sandbox are Linux only.
Windows (x86_64 and arm64)	Supported
FreeBSD	Coming next
Languages with structural analysis	Python, TypeScript, JavaScript, Go, Rust, Java, C#, Kotlin, C and C++. Other files merge line by line.
COBOL and JCL	With gitta Enterprise. Meaning analysis of programs, copybooks and JCL steps. See Mainframe guide.