Skip to content
ThoughtBridge

Documentation Get started

Overview

The pieces of ThoughtBridge - apps, destinations, the API, and the runner - and where to find the documentation for each.

ThoughtBridge captures spoken thoughts on your devices, routes each one to the right project with AI, and files it as structured Markdown in a place you own. This documentation covers the parts you can build on: the API and the runner.

The pieces

  • The apps (iPhone, iPad, Apple Watch, Mac) capture thoughts and manage projects. See how it works for the product tour.
  • Destinations are where filed thoughts live outside the app: a GitHub repo, Google Drive, or a local or iCloud folder. The how-tos walk through connecting them.
  • The API gives your own scripts and agents machine access to your thoughts and projects, authenticated with an API key you create in the app. Start with API keys, then using the API and the API reference.
  • The runner (Bridget) is a small open-source daemon that runs on your own machine and turns “bridge it” thoughts into pull requests, using your own coding agent. Start with the runner and runner configuration.

A note on the beta

ThoughtBridge is in beta. The endpoints documented here are the stable, versioned surface (/v1); anything not documented may change without notice. When something here disagrees with what the API actually does, tell us - that is a bug in the docs or the API, and we want to know. If something is not working, start with troubleshooting.