t3-signal-bridge
v0.1.5
Published
Start, answer and follow T3 Code threads from Signal
Maintainers
Readme
T3 Code Signal Bridge
An unofficial bridge to start, answer and follow T3 Code threads from Signal:
- Message the bot to start a thread.
- Quote-reply to a bot message to answer its thread.
- Bot reacts 👀 when it gets your message and replies when its thread finishes.
- Let agents ask you questions and wait for your answer.
Installation
You need:
- T3 Code, on a Linux machine with systemd.
- Node.js 22.13 or later.
- A phone number for the bot. A cheap prepaid SIM or eSIM works; virtual numbers usually don't.
Run the installer on the machine where T3 Code runs:
npx t3-signal-bridge installThe installer asks for the bot's number, your Signal number and the project that new threads start in. It registers the bot with Signal, sends you a test message and starts the bridge as a background service.
On your phone, save the bot as a contact so that its messages notify you.
To change your settings, run npx t3-signal-bridge install again.
Usage
A message to the bot starts a thread in the project you chose during install. To start it in another project, begin the message with the project's name and a colon:
api: bump the dependenciesThe project name is its T3 Code title in lowercase, with dashes for spaces, so "My API" becomes my-api.
To let agents ask you questions, add this line to your AGENTS.md or to a scheduled task's prompt:
If you can't continue without the owner's decision, run `signal-ask "<question>"` and end your turn. Their reply arrives as your next message.Reference
| Command | What it does |
| ------------------------------------ | -------------------------------------------------------------------------------------- |
| npx t3-signal-bridge status | Shows whether the bridge's service is installed and running, and where its logs are. |
| npx t3-signal-bridge@latest update | Installs the latest version and restarts the bridge. |
| signal-ask "<question>" | Sends a question from the T3 Code thread it runs in. Pipe longer questions on stdin. |
| npx t3-signal-bridge uninstall | Stops the bridge and removes its service. Keeps your config and the bot's Signal keys. |
