About
GitSocial is a decentralized social network built entirely on Git: posts are commits, follows are lists of repositories stored as references, and syncing uses git fetch/push. You own your data and your social graph, with offline-first support on GitHub, GitLab, self-hosted, or local repositories.
How It Works
Posts are commits
Every post is a commit on your gitsocial branch, as are comments, reposts, and quotes, which link to their parent posts via GitMsg headers to form conversation threads.
Follows are lists
Follows are lists of repositories like "OSS" or "AI", stored as Git references, with posts from your lists appearing in your timeline.
Syncing via Git
Updates use git fetch, publishing uses git push, with no special servers or APIs needed.
Quick Start
- Open GitSocial in VS Code's sidebar, create a list, and add repositories to see them on your timeline
- Write posts, comment on others, and publish using push
Requirements
- VS Code 1.74.0 or higher
- Node.js 20.0.0 or higher
- Git repository
Documentation
Specifications
- GITSOCIAL.md - GitSocial protocol specification, social extension to GitMsg protocol
- GITMSG.md - GitMsg message protocol specification
Development
License
MIT
