Skip to content
ThoughtBridge
Log in

How-tos

Connect a GitHub destination

File your thoughts into a repo as Markdown, plain text, or JSON — with agent files so Claude, ChatGPT, and Cursor read them in context.

A destination is where your filed thoughts live outside the app. For anyone who works in code, a GitHub repo is the natural one: thoughts arrive as committed files, versioned and readable by every AI tool you already point at the repo.

What you’ll end up with

Inside your chosen repo, ThoughtBridge maintains a folder per project:

your-repo/
  my-project/
    thoughtbridge/
      AGENTS.md
      thoughts/
        2026-07-26-launch-email-angle.md
        ...
  another-project/
    thoughtbridge/
      ...
  • Each thought is one file — Markdown, plain text, or JSON, your choice.
  • AGENTS.md and companion files tell agents what the folder is and how to use it, so Claude Code, Cursor, or ChatGPT pick up your thinking without any prompting ritual.
  • One destination can host many projects — you don’t need a repo per project.

Connect the repo

  1. In the app, go to the Projects tab and open the project you want to wire up (or create one).
  2. Choose Add destination, then GitHub.
  3. Sign in to GitHub when prompted and grant access to the repository you want to use. ThoughtBridge only writes inside the project’s folder — it never touches the rest of the repo.
  4. Pick the repo, choose a format (Markdown is the friendliest default), and confirm.

That’s it. The destination is scaffolded on the next filed thought — folder, agent files, and all.

Share one repo across projects

Point additional projects at the same repo and each gets its own slug-named folder. A single thoughts repo can quietly become the memory for everything you’re working on.

Let your tools read it

Clone the repo (or open it where it already lives) and start your AI tool in it. The agent files do the introductions; your recent thoughts are right there as dated files. Ask “what was I thinking about the launch email?” and the answer is on disk.

Honest notes for the beta

  • Writes are one-way during the beta: the app files thoughts into the repo; it doesn’t yet sync edits you make to the files back into the app.
  • Prefer not to use GitHub? Google Drive and local or iCloud folders work the same way — same structure, same formats, same agent files.