# Bridgit

> Bridgit is an Android app that lets the owner's AI agents use their phone (camera, microphone, screen, location, cards that ask the owner questions, speaker, files, schedules and more) through a local HTTP API and MCP server on the owner's Tailscale network. One key per agent; every call is logged on the phone.

Everything below is public, needs no key and no phone, and is rebuilt from the latest Bridgit code (API revision 39, app 1.8.0). Your phone serves its own copies (`GET /v1/guide` and friends) with its switch states and address; if its `api_revision` (in `GET /v1/health`) is lower, it runs an older Bridgit: see the change log for what it lacks.

## Learn

- [Index (JSON)](https://bridgit.cc/learn/index.json): every document below, with the current revision and counts
- [Guide](https://bridgit.cc/learn/guide.md): the full agent guide, every endpoint, cards, events, schedules, conventions, errors
- [API list](https://bridgit.cc/learn/endpoints.json): 116 endpoints with parameters, examples, errors and MCP tool names
- [OpenAPI 3.1](https://bridgit.cc/learn/openapi.json)
- [Change log](https://bridgit.cc/learn/changes.json): what each API revision added, 1 to 39
- [Error codes](https://bridgit.cc/learn/errors.json): 35 codes, what each means and what to do
- [MCP](https://bridgit.cc/learn/mcp.md): connecting as an MCP client, and every tool
- [Decisions](https://bridgit.cc/learn/decisions.md): read before building an app that decides things. Typed answers with a confidence from Jev (text) and Clef (photos, sound, video): which to use, how to ask, what it costs
- [Agent control tools](https://bridgit.cc/learn/control.md): the second MCP server (`POST /mcp`) and `/v2` routes, 48 tools for using apps on screen, workflows, OCR, translation, notifications, sensors, peripherals and alerts

## Cards and demo

- [Interaction samples](https://bridgit.cc/samples/samples.json): a tested request body for every card kind (notice, question, html, text), with the answer each produces
- [Interaction examples](https://bridgit.cc/interactions/index.json): 22 everyday cards to copy and change
- [Demo script](https://bridgit.cc/learn/demo.md): the five-minute first-run tour and the menu of more demos ([tour alone as a skill](https://bridgit.cc/demo/SKILL.md))

## Bugs and feature requests

- [How to file them](https://bridgit.cc/learn/bugs.md): with the phone (`POST /v1/feedback`) or without one (`POST https://bridgit-feedback.bridgit-app.workers.dev/v1/agents/register`, then `POST https://bridgit-feedback.bridgit-app.workers.dev/v1/agent/reports`). The team reads every one.

## Optional

- [API page](https://bridgit.cc/api/): the human-readable reference
- [Developers](https://bridgit.cc/developers/)