GitSocial - Cross-forge collaboration platform

Cross-forge collaboration platform

GitSocial stores your collaboration data (issues, pull requests, etc) as commits on<br>gitmsg/* branches with structured trailers, so your<br>data is tied to your repo, not the hosting platform.

GitSocial fetches into timeline activity from repositories added to lists or registered as<br>forks.

Watch demo →

Installation

macOS / Linux with Homebrew

brew trust gitsocial-org/tap<br>brew install gitsocial-org/tap/gitsocial

Or using installation script<br>curl -fsSL https://gitsocial.org/install.sh | sh

Windows

scoop bucket add gitsocial https://github.com/gitsocial-org/scoop-bucket.git<br>scoop install gitsocial

Go

go install github.com/gitsocial-org/gitsocial/cli/gitsocial@latest

Or download a binary from Releases.

Quick Start

Clone your project from GitHub or any host, then from your project directory:

gitsocial import # imports issues, PRs, releases, discussions<br>gitsocial tui # explore in the terminal

Documentation

Concepts

Doc<br>Description

GitMsg Protocol<br>Core message format, headers, refs, versioning

Identity<br>Verification<br>Decentralized trust model, attestation sources, caching

Notifications

Notification types, scopes, and triggers

Extensions

Doc<br>Description<br>Spec

Social<br>Posts, comments, lists, timeline, followers<br>GitSocial

PM<br>Issues, milestones, sprints, labels, boards<br>GitPM

Review<br>Pull requests, feedback, forks, version tracking, cross-forge scenarios<br>GitReview

Release<br>Releases, artifacts, checksums, signatures, SBOM<br>GitRelease

Memo<br>Tiered memos for knowledge as commits

Clients

Doc<br>Description

Agent Skill<br>AI-assisted workflows for Claude Code, Cursor, and other agents

TUI

Per-view layout diagrams (see also keybindings)

CLI<br>Commands, flags, output formats

JSON-RPC<br>Client integration over stdio

Contributing

Platform issues and PRs are disabled on all mirrors. GitSocial uses its own tools for collaboration.

Getting Started

Install GitSocial (see Installation)

Fork the repository on any host (GitHub, GitLab, Codeberg, or self-hosted)

Clone your fork: git clone https://your-host.com/you/gitsocial

Read Architecture<br>for system design, packages, and cache layout

Submitting Pull Requests

git checkout -b feature/my-change # make changes, commit

gitsocial review pr create \<br>--base main \<br>--head feature/my-change \<br>"Short description of change"

git push origin feature/my-change # push your branch<br>gitsocial push # push PR metadata<br>After your first push, request fork registration in the Matrix room so maintainers can<br>discover your PRs and issues.

See Review for the<br>full cross-forge PR workflow.

Reporting Bugs & Requesting Features

gitsocial pm issue create "Bug: description"<br>gitsocial push<br>For quick questions or discussion, use the Matrix room.

License

MIT