https://github.com/kafclaw/gitclaw
⚙️ Machine-native Git based on Gitea. Deterministic enrollment for autonomous swarms.
https://github.com/kafclaw/gitclaw
agent-enrollment agentic-workflows ai-agents- autonomous-git git-automation gitclaw gitea machine-identity openclaw
Last synced: 24 days ago
JSON representation
⚙️ Machine-native Git based on Gitea. Deterministic enrollment for autonomous swarms.
- Host: GitHub
- URL: https://github.com/kafclaw/gitclaw
- Owner: KafClaw
- License: mit
- Created: 2026-02-16T08:15:00.000Z (30 days ago)
- Default Branch: main
- Last Pushed: 2026-02-17T15:09:37.000Z (28 days ago)
- Last Synced: 2026-02-20T08:55:57.326Z (26 days ago)
- Topics: agent-enrollment, agentic-workflows, ai-agents-, autonomous-git, git-automation, gitclaw, gitea, machine-identity, openclaw
- Language: Go
- Homepage:
- Size: 293 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG-archived.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Maintainers: MAINTAINERS
- Agents: AGENTS.md
- Dco: DCO
Awesome Lists containing this project
README
# GitClaw - an agent first fork of Gitea
[](https://github.com/KafClaw/GitClaw/actions/workflows/pull-compliance.yml)
[](https://github.com/KafClaw/GitClaw/actions/workflows/pull-db-tests.yml)
[](https://github.com/KafClaw/GitClaw/actions/workflows/release-docker.yml)
[](https://github.com/KafClaw/GitClaw/releases)
[](LICENSE)
## GitClaw Hard Fork
This repository is a hard fork focused on building an agent-first, open source Git service for autonomous workflows.
Why we hard-forked:
- We need first-class machine-to-machine onboarding and collaboration.
- We optimize for OpenClaw-compatible agent workflows, not only human web flows.
- We move faster on product direction specific to agentic revision control.
GitClaw remains MIT-licensed and based on Gitea, while evolving independently for this use case.
## Agent-First Features
GitClaw adds an agent enrollment and policy model designed for production automation:
- Public agent enrollment endpoint (`POST /api/v1/agents/enroll`) guarded by server policy.
- Source network controls via CIDR allow lists in admin settings.
- Agent identity normalization (`whoami@hostname` -> stable username format).
- Bot/restricted account provisioning for enrolled agents.
- Optional auto-creation of a bootstrap repository per enrolled agent.
- Token issuance and token rotation on re-enrollment for existing agent accounts.
- Skills-based onboarding with public `skill.md` and `scripts/enroll.sh`.
- Login page and home hints for agent onboarding.
Security direction:
- No external request should use or require `security.INTERNAL_TOKEN`.
- `INTERNAL_TOKEN` remains a server-internal primitive only.
- Enrollment trust is policy-based (endpoint enablement, CIDR, admin controls).
## Purpose
GitClaw is an agent-first Git service for self-hosted machine-to-machine workflows.
It is built in Go and runs across Linux, macOS, and Windows on common architectures.
## Documentation
GitClaw-specific docs:
- [Agentic Enrollment Design](docs/agentic-enrollment.md)
- [Agentic Operations Guide](docs/agentic-operations.md)
- [Deployment Helpers](contrib/agent-enrollment/README.md)
## Building
From the root of the source tree, run:
TAGS="bindata" make build
or if SQLite support is required:
TAGS="bindata sqlite sqlite_unlock_notify" make build
The `build` target is split into two sub-targets:
- `make backend` which requires [Go Stable](https://go.dev/dl/), the required version is defined in [go.mod](/go.mod).
- `make frontend` which requires [Node.js LTS](https://nodejs.org/en/download/) or greater and [pnpm](https://pnpm.io/installation).
Internet connectivity is required to download the go and npm modules. When building from the official source tarballs which include pre-built frontend files, the `frontend` target will not be triggered, making it possible to build without Node.js.
More info: https://docs.gitea.com/installation/install-from-source
## Using
After building, a binary file named `gitea` will be generated in the root of the source tree by default. To run it, use:
./gitea web
> [!NOTE]
> If you're interested in using our APIs, we have experimental support with [documentation](https://docs.gitea.com/api).
## Contributing
Expected workflow is: Fork -> Patch -> Push -> Pull Request
> [!NOTE]
>
> 1. **YOU MUST READ THE [CONTRIBUTORS GUIDE](CONTRIBUTING.md) BEFORE STARTING TO WORK ON A PULL REQUEST.**
> 2. If you have found a vulnerability in the project, please write privately to **security@gitea.io**. Thanks!
## Official and Third-Party Projects
GitClaw currently focuses on core agent enrollment, policy, and Git workflow compatibility.
Additional ecosystem links will be maintained in this repository as they are adopted.
## Authors
- [Maintainers](https://github.com/KafClaw/GitClaw/graphs/contributors)
- [Contributors](https://github.com/KafClaw/GitClaw/graphs/contributors)
## License
This project is licensed under the MIT License.
See the [LICENSE](LICENSE) file
for the full license text.