# GitCafe documentation

Create repositories, collaborate on changes, and manage your account and
organizations.

Start with [creating a repository](https://git.cafe/docs/repositories/repository-create.md)
or [importing from GitHub](https://git.cafe/docs/integrations/github-sync.md). Coding agents and other
tools can start with [What can I do with GitCafe?](https://git.cafe/docs/agent-workflows.md).

Paths such as `/settings/account` are relative to your GitCafe site. Replace
`<owner>`, `<repo>` and similar placeholders with your own values. Some features
require your instance operator to enable an integration; the relevant guide
explains what is available and what to expect when it is unavailable.

## Find and read content

Use **Search GitCafe** in the site navigation to search published guides,
public people by handle prefix and, when signed in, repositories you can access
by name prefix. This is not global code or issue search; use a repository's
search tools for those. A failed search source does not hide other results.

Guides, legal pages and supported resource pages can also be read as Markdown:
send `Accept: text/markdown` or append `?format=markdown` to the page URL. Keep
existing query parameters and add `&format=markdown` when needed. A known page
without the requested representation returns 406. A missing route returns 404;
adding `?format=markdown` does not make an unknown route available. Sign-in-required
workflows return 401. Private resources may return 404 to conceal their existence.
Authentication and private repository concealment apply equally to HTML and Markdown.

Root `/llms.txt` indexes every published guide and site page as Markdown, and
`/llms-full.txt` contains all of them in one file. A repository's
`/<owner>/<repo>/llms.txt` gives its metadata, a bounded default-branch root tree,
the README's opening and where to go next. These are reading aids, not complete
repository exports. The site sitemap contains public site pages,
not private repositories.

Resource Markdown covers repository/profile summaries, source trees and files,
commits/history, issues, pulls, stacks, branches and tags. Issue/pull lists default
to open items, as the browser does. Detail pages include authored bodies; discussion,
reviews and checks link to the browser rather than being copied. Pull-request
commits and text patches have [bounded Markdown documents](https://git.cafe/docs/collaboration/pull-request.md#read-commits-and-diffs-as-markdown).
Lists are bounded:
history 100 commits, issue/pull/stack 30 rows, owner repositories 20 rows and
refs 100 rows; a tree document lists the whole directory. Follow the document's
next-page link where it has one; a history document names the API cursor that
continues it. Unsupported browser filter combinations do not advertise
a Markdown alternate. Oversized or unsupported README previews show an explicit
notice and snapshot link without hiding the repository overview.

### Follow repository URLs

Start with `/<owner>/<repo>/llms.txt` and follow its resource links. They select
Markdown explicitly, so no custom request headers are needed. Source URLs use
`/<owner>/<repo>/tree/<revision>/<path>` for directories and
`/<owner>/<repo>/blob/<revision>/<path>` for files. History uses
`/<owner>/<repo>/commits/<revision>`; a commit uses
`/<owner>/<repo>/commit/<oid>`. Omit `<path>` for the root tree.

A requested revision can name a branch, an encoded full ref such as
`refs%2Fheads%2Fmain`, or a commit OID. Snapshot links use the resolved commit OID
so their files remain tied to the document you read. Encode slashes within a ref
as `%2F`; slashes between file path segments remain `/`.
Relative links in an included README resolve inside that same snapshot. Supported
relative images use the authorized image endpoint pinned to the snapshot commit;
external destinations remain unchanged.

Use the advertised `.md` alternate for document routes, or append
`?format=markdown`. Source file paths are exact: `.md` inside a blob path is
part of the filename and is never treated as a representation suffix.

## Repositories

- [Create a repository](https://git.cafe/docs/repositories/repository-create.md) or
  [import from GitHub](https://git.cafe/docs/integrations/github-sync.md).
- Browse [branches](https://git.cafe/docs/repositories/branches.md), [tags](https://git.cafe/docs/repositories/tags.md),
  [commit history](https://git.cafe/docs/repositories/commits.md), [a commit](https://git.cafe/docs/repositories/commit.md)
  and [code search](https://git.cafe/docs/repositories/code-search.md).
- Manage [access](https://git.cafe/docs/repositories/repository-access.md),
  [rulesets](https://git.cafe/docs/repositories/repository-rulesets.md),
  [administration and deletion](https://git.cafe/docs/repositories/repository-danger-zone.md), and
  [stars](https://git.cafe/docs/repositories/repository-stars.md).

## Collaboration

- Pull requests: [list](https://git.cafe/docs/collaboration/pull-requests.md),
  [create](https://git.cafe/docs/collaboration/pull-request-create.md),
  [pull request page](https://git.cafe/docs/collaboration/pull-request.md),
  [review drafts](https://git.cafe/docs/collaboration/pull-review-drafts.md) and
  [stacks](https://git.cafe/docs/collaboration/stacks.md).
- Issues: [list and creation](https://git.cafe/docs/collaboration/issues.md) and
  [moderation](https://git.cafe/docs/collaboration/issue-moderation.md).
- Shared organization: [labels](https://git.cafe/docs/collaboration/labels.md) and
  [milestones](https://git.cafe/docs/collaboration/milestones.md).

## Account

- [Account settings](https://git.cafe/docs/account/account-settings.md),
  [appearance](https://git.cafe/docs/account/appearance.md), [billing](https://git.cafe/docs/account/billing.md),
  [public profiles](https://git.cafe/docs/account/public-profiles.md) and
  [profile management](https://git.cafe/docs/account/profile-management.md).
- [Personal access tokens](https://git.cafe/docs/account/personal-access-tokens.md),
  [device authorization](https://git.cafe/docs/account/device-authorization.md),
  [MCP app connections](https://git.cafe/docs/account/mcp-connections.md),
  [SSH keys](https://git.cafe/docs/account/ssh-keys.md) and [GPG keys](https://git.cafe/docs/account/gpg-keys.md).
- [Password recovery](https://git.cafe/docs/account/password-recovery.md).

## Organizations

- [Organizations](https://git.cafe/docs/organizations/organizations.md),
  [members](https://git.cafe/docs/organizations/organization-members.md),
  [invitations](https://git.cafe/docs/organizations/organization-invitations.md),
  [settings](https://git.cafe/docs/organizations/organization-settings.md) and
  [teams](https://git.cafe/docs/organizations/teams.md).
- Organization [billing](https://git.cafe/docs/account/billing.md) and
  [public profiles](https://git.cafe/docs/account/public-profiles.md) share their account guides.

## Integrations

- [GitHub import and sync](https://git.cafe/docs/integrations/github-sync.md).
- [Git mirrors with another server](https://git.cafe/docs/integrations/git-mirrors.md).
- [Buildkite results and settings](https://git.cafe/docs/integrations/buildkite-ui.md).
