Knowledge Sync

Your knowledge, in files you own.

Notes sync to a GitHub repository as plain markdown and changes read back. Edit in Obsidian, edit here, it is the same source of truth either way.

There's a better way

The Old Way

  • Your notes live in a database you cannot open
  • Export is a button you hope still works when you need it
  • Editing in your own tools means a second, diverging copy
  • Cancelling the subscription means losing the archive

The BlackOps Way

  • Plain markdown in a repository you already control
  • Two-way sync, so your editor and BlackOps see the same note
  • Folder layout decided by ordered routing rules
  • The files keep working whether or not BlackOps does

Why Knowledge Sync?

Ownership that survives the subscription

Plain markdown you own

Notes land in a repository you control as ordinary files. No proprietary format, no export step, nothing that stops being readable if you stop paying.

It reads changes back

Edit a note in Obsidian or your editor and the change comes back. The repo is not a backup, it is the other half of the same system.

Folder routing you configure

Ordered rules map tags and note types to destination folders, so where a file lands is a rule rather than a habit.

Optional, not required

Brains work without a repository: source notes live in BlackOps and compile on their own. Connecting GitHub is an upgrade for people who want the files.

How It Works

1

Connect a repository

Point BlackOps at a repo you own. An Obsidian vault works well, because the result is just a folder of markdown.

2

Notes sync out as files

Every note commits to the folder your routing rules choose. Your taxonomy decides the layout, not the tool.

3

Edit anywhere, compile everywhere

A vault-backed brain reads its source notes from that folder, so editing in your own tools still feeds what your AI knows.

Keep the files.

A knowledge base you cannot take with you is not yours.