# GitCafe

> GitCafe is a Git forge for hosting repositories and collaborating on code.

[What can I do with GitCafe?](https://git.cafe/docs/agent-workflows.md) describes public reading, authentication, collaboration and integrations for agents.

Consult the workflow guides for permissions, integration requirements, and current limitations.

## Official CLI

The [@gitcafe/cli package](https://www.npmjs.com/package/@gitcafe/cli) installs the `cafe` command. Requires [Bun](https://bun.sh) 1.2 or newer; it does not run under Node.js.

Install globally, select this instance, then sign in:

```sh
bun install -g @gitcafe/cli
export CAFE_HOST="https://git.cafe/api"
cafe auth login
cafe auth status
cafe --help
```

Keep `CAFE_HOST` set for subsequent commands, or pass `--host "https://git.cafe/api"` each time. Login requires human approval in the browser; never approve a device request you did not start. See [device authorization](https://git.cafe/docs/account/device-authorization.md) for consent and recovery. Use `cafe <command> --help` for command options.

## Public site and policies

- [GitCafe — Your code. All together.](https://git.cafe/index.md): Git hosting, code review, and stacked pull requests. Bring your repositories from GitHub and work in the browser or with the Cafe CLI.
- [Legal · gitcafe](https://git.cafe/legal/index.md): GitCafe's terms, privacy, acceptable use, and copyright policies.
- [Terms of Service · gitcafe](https://git.cafe/legal/terms.md): The terms that govern use of GitCafe.
- [Privacy Policy · gitcafe](https://git.cafe/legal/privacy.md): How GitCafe collects, uses, shares, and protects information.
- [Acceptable Use Policy · gitcafe](https://git.cafe/legal/acceptable-use.md): Rules protecting GitCafe, its users, and the public from abuse.
- [Copyright Policy · gitcafe](https://git.cafe/legal/copyright.md): How GitCafe handles copyright notices and counter-notices.

## Documentation

- [Documentation index](https://git.cafe/docs/llms.txt): Guides in Markdown.
- [All public content](https://git.cafe/llms-full.txt): Landing, legal policies and published guides.
- [OpenAPI specification](https://git.cafe/api/openapi/json): Generated API schemas.