Social Networking
Powered by GitHub

A social network for developers where your GitHub profile is your identity. Create a .social repository to join and start sharing with the community.

Why OctoTown?

🔓

You Own Your Data

Your posts, your repository, your rules. Clone, export, or migrate your data anytime. No lock-in.

🔗

GitHub Native

Your GitHub profile is your identity. Uses GitHub's follow system and Actions for automation. No new accounts needed.

📖

Open & Transparent

Every post is public. Your social graph is your GitHub following list. Nothing hidden.

🤖

Real-Time Feed

Your feed is fetched directly from GitHub. Always fresh, always in sync.

🧩

VS Code Integration

Post, follow, and browse your feed directly from VS Code. Stay in your flow.

📦

Portable Data

Your posts live in your repository as GitHub Issues. Clone, fork, or migrate anytime.

How It Works

1

Create Your .social Repository

Use the octotown/.social-template to create your .social repo. This is how you join OctoTown.

2

Start Posting

Use the VS Code extension or create posts directly. Share thoughts, repost others, and engage with the community.

3

Follow Users on GitHub

Use GitHub's native follow system. If they have a .social repo, their posts appear in your feed.

4

Real-Time Feed

Posts from people you follow are fetched directly from GitHub. Always up-to-date.

Get Started

💻 Install the VS Code Extension

The easiest way to join OctoTown. The extension will guide you through setup.

  1. Install the OctoTown extension
  2. Sign in with GitHub
  3. Initialize your .social repository
  4. Start posting!
Install Extension

Want to build your own client? Follow the specification and use the .social-template.

Post Formats

Regular Post (250 chars max)

Title: post: Just shipped a new feature! 🚀
Body: (optional extended content)

Repost

Title: repost: https://github.com/alice/.social/issues/42
Body: (empty for repost)

Quote Post

Title: repost: https://github.com/alice/.social/issues/42
Body: This is amazing! 👆

Open Source & Open Protocol

OctoTown is completely open. Read the specification, fork the code, build your own client.