Skip to content

docs(signal): clarify Signal channel is an inbound inbox, not a self-text channel #359

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MatthewSuttles wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(signal): clarify Signal channel is an inbound inbox, not a self-text channel #359

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion app/views/channels/_form.html.erb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -296,7 +296,14 @@
<li>That links Hivemind as a secondary device — no manual registration needed</li>
</ol>
<p class="text-text-faint text-xs mt-3">Phone number is optional — it's auto-detected after linking. Only set it if you registered a number directly with signal-cli.</p>
<div class="mt-4 bg-surface-card rounded-lg px-4 py-3 border border-border-default">
<div class="mt-4 bg-amber-900/20 rounded-lg px-4 py-3 border border-amber-700/50">
<p class="text-amber-200 text-sm">
<strong class="text-white">What this is:</strong>
a Signal inbox others can message to reach your agent — not a way to text your agent from your own number.
Messages you send from the linked account (including <strong class="text-white">“Note to Self”</strong>) are dropped as loop protection. Test it from a different phone.
</p>
</div>
<div class="mt-3 bg-surface-card rounded-lg px-4 py-3 border border-border-default">
<p class="text-text-muted text-sm">
<strong class="text-white">Delivery:</strong>
The connector polls signal-cli for new messages — no public URL needed.
Expand Down
16 changes: 16 additions & 0 deletions app/views/channels/connect.html.erb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,22 @@
<p class="text-text-muted mt-2">Scan the QR code with your phone to link this <%= platform_name %> account</p>
</div>

<% if @channel.channel_type == "signal" %>
<!-- How this works (Signal expectation-setting) -->
<div class="bg-amber-900/20 border border-amber-700/50 rounded-xl p-5 mb-6">
<div class="flex gap-3">
<svg class="w-5 h-5 text-amber-400 flex-shrink-0 mt-0.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
<div class="text-sm space-y-2">
<p class="text-amber-200 font-medium">This makes your agent reachable on Signal — it's not a personal back-channel.</p>
<p class="text-text-muted">Linking this number turns it into an inbox that <strong class="text-white">other people</strong> can message to reach your agent. Share the number, and anyone who texts it gets a reply.</p>
<p class="text-text-muted"><strong class="text-white">Heads up:</strong> messaging this number from <em>your own</em> Signal account — including <strong class="text-white">“Note to Self”</strong> — won’t reach the agent. Signal drops your own messages as loop protection. To test it, message the number from a different phone or ask a friend to.</p>
</div>
</div>
</div>
<% end %>

<!-- Status -->
<div class="bg-surface-card rounded-xl border border-border-default p-8 text-center mb-6">
<!-- Connection Status Badge -->
Expand Down
Loading