Skip to content
ThoughtBridge
Log in

Documentation

Reference material for building on ThoughtBridge: the API your scripts and agents can call, and the runner that turns thoughts into pull requests. For guided walkthroughs, see the how-tos.

Get started

What ThoughtBridge is made of and where to begin.

  • Overview

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

  • Troubleshooting

    What to do when a thought is stuck, a limit is reached, a sign-in or permission fails, or nothing shows up in your destination.

API

Machine access to your thoughts - keys, conventions, and every endpoint.

  • API keys

    Create, scope, and revoke the keys that give scripts, agents, and the runner machine access to your thoughts.

  • Using the API

    Base URL, authentication, the endpoint allowlist, errors, and rate limits - everything that applies to every request.

  • API reference

    The endpoints available to API keys - listing and reading thoughts and projects, and updating statuses and tasks.

  • Capture thoughts from anywhere

    Turn any script into a capture source - the GitHub Action for CI failures, or three HTTP calls from anywhere else.

Runner

Bridget, the local daemon that turns "bridge it" thoughts into pull requests.

  • The runner

    What Bridget is, how a bridge-it run works end to end, and the safety rules it enforces.

  • Runner configuration

    Profiles, runner.yaml, and every environment variable - one process driving as many agent identities as you like.