Six Degrees GitHub

Docs

Getting started, and questions

Everything you need once it's installed: how to bring your network in, where it lives, and what the app does and doesn't do.

Get started

Bring your network in

The app opens on three ways in, from no risk at all to the full picture. Scanning is the only one that shows who your connections know.

No LinkedIn risk

Explore a sample

150 invented connections and the 598 people they know. Every view except Outlink and Scores, which need your own scan.

No LinkedIn risk

Import LinkedIn's export

LinkedIn's own Connections.csv, read on your computer: Settings & Privacy → Data privacy → Get a copy of your data → Connections. It shows the people you know, not who they know, so there's no Degrees or Outlink.

Your account, your risk

Scan your LinkedIn

The only way to see who your connections know. The app opens Google Chrome with a profile of its own, you sign into LinkedIn there yourself, and it reads slowly with daily limits.

Importing LinkedIn's export (half a minute): ask LinkedIn for your Connections file, then drop it on the app. No sign-in, and no risk to your account.

Scanning uses your own LinkedIn account, and LinkedIn may restrict accounts that automate it. Automating LinkedIn may break its User Agreement. The scanner reads slowly, keeps to a budget and stops at the first push-back, but the risk is yours. The sample and the CSV import carry no LinkedIn risk at all. How scanning works.

How scanning works (under a minute): sign into LinkedIn in the Chrome window it opens, scan the people you know, then map who they know a few at a time.

Your data

One folder, on your computer

Your network lives in a hidden folder in your home folder, .six-degrees. Open it any time with Help → Show the Data Folder, and see what each part takes up in Settings → Your data.

  • Backups. Each new version copies your network into backups/ before it first opens it, and so does an import.
  • Moving to a new computer. Settings → Your data → Save a copy of my network makes one file. Move it yourself, and import it on the other computer. Your LinkedIn sign-in never goes into a copy.
  • The one thing to guard. chrome-profile/ holds the scanner's signed-in LinkedIn session. Never copy, sync or share it; deleting it just means signing in again.

Every detail, including how to undo an import, is in the README.

Privacy

What it contacts, and when

This website has no trackers either. To show the latest version and the number of stars, it asks GitHub.

Questions

Questions people ask

Is Six Degrees free?
Yes. It's free and open source under the MIT licence, with no account, no subscription and no paid tier. Every line of code is on GitHub.
Does it upload my LinkedIn data anywhere?
No. Your network stays on your Mac, in a hidden .six-degrees folder. There's no telemetry, no analytics and no crash reports. It only goes online when you act: LinkedIn while you scan, and GitHub when you check for an update.
Does it work on Windows?
Not yet. Six Degrees is a Mac app for Apple Silicon and Intel Macs on macOS 13.5 or later, and it runs on Linux with npx six-degrees. A Windows version is planned, without a date.
Why does macOS say it can't check the app for malware?
Because the app isn't signed with Apple's paid developer certificate yet. Allow it once in System Settings → Privacy & Security → Open Anyway, or use the one-line Terminal install, which checks the download against the published checksums before opening it.
Is scanning LinkedIn against LinkedIn's rules?
Automating LinkedIn may break its User Agreement, and LinkedIn can restrict an account for it. Scanning is optional, slow on purpose, kept to a daily budget, and stops at the first push-back. The sample network and LinkedIn's own CSV export carry no risk to your account.
What do I need to get started?
A Mac and, optionally, LinkedIn's Connections.csv export (Settings → Data privacy → Get a copy of your data). Or nothing: a sample network of 150 invented people ships with the app, so you can explore every view before importing anything.
What does “six degrees” mean here?
The idea that anyone is reachable through a short chain of people who know each other. The app draws your chain: who you know, who they know, and the shortest introduction path from you to someone you haven't met.
How is someone's score worked out?
From their title and their company: power = title × (0.45 + 0.055 × company score), plus a small bonus for reach and for a strong circle. It estimates network position, not what anyone is worth as a person. Scanned and sample people show the working on their card.

Go deeper

The full documentation