@aalzubidy/pi-signal
Bidirectional messaging integration between pi and Signal
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: @aalzubidy/pi-signal. It is used for: Bidirectional messaging integration between pi and Signal Full Skill content: https://321skill.com/skills/aalzubidy-pi-signal/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the inability to communicate directly with an AI agent via Signal Messenger on the pi platform. In practical development, developers often need a convenient mobile input method for LLMs to process messages and auto-reply, and Signal's Note-to-Self feature provides a secure, private channel for this purpose.
Usage is straightforward: install the package in pi, run the /signal-setup command to get the setup.sh script path, execute the script in a terminal to complete device linking and systemd service configuration. Then, set the environment variables PI_SIGNAL_ACCOUNT and PI_SIGNAL_PRIMARY, and restart pi. Send a Note-to-Self message to pi, and it will automatically receive (👀), process, and reply (✅).
It is ideal for agent developers who need to use their phone as an AI agent input terminal, especially those already using the pi platform and looking to extend messaging channels. It's also suitable for scenarios requiring quick LLM response testing, allowing you to send commands from your phone without opening a computer.
During setup, ensure signal-cli is correctly installed and Java version is ≥ 25. Note that it only processes Note-to-Self messages; messages from other senders are ignored for security. If connection issues arise, check that the PI_SIGNAL_DAEMON_URL environment variable points to the correct daemon address.
Key Features
Unlike using the signal-cli command-line tool directly, it automatically handles messages via pi extension, eliminating the need for manual polling scripts; and it processes only Note-to-Self messages, avoiding the security risk of accidentally handling messages from others.
Limitations
Requires Java 25+ and signal-cli installed and configured with a Signal account, and only supports Note-to-Self messages—messages from other senders are ignored.
FAQ
How do I install signal-cli?
Please refer to the official documentation at https://github.com/AsamK/signal-cli/ and ensure it's added to your PATH.
How do I obtain a Signal account?
Install the Signal app on your phone, register an account, then complete device linking by scanning the QR code in the setup.sh script.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/aalzubidy-pi-signal/raw/index.md to read the original Skill definition (Markdown format) for @aalzubidy/pi-signal, and install it according to the instructions.
Raw Markdown URL for AI: /skills/aalzubidy-pi-signal/raw/index.md