Terminull

Developer Docs

Terminull runs AI coding agents on your own machine and drives them from your phone. A small bridge on the desktop wraps each agent in a pluggable adapter that normalizes its output into a uniform block stream the app renders. This page documents how to write your own adapter — the part of Terminull that’s meant to be open and extended — and how pairing, re-pairing, and sharing a machine differ.

Contents

  1. Writing a custom adapter
    1. The BaseAdapter contract
    2. A minimal adapter
    3. Capabilities
    4. Detection & drop-in install
    5. Lifecycle across a two-surface run
  2. Pairing, re-pairing & sharing a machine
    1. Pairing — linking a machine the first time
    2. Re-pairing — scanning again from the same account
    3. Sharing — letting someone else use your machine
    4. Which QR am I looking at?
    5. LAN-only pairing

The bridge core is intended to be open. Source layout, the full block reference, and the handoff design live alongside this in the repo's docs/. Questions: [email protected].