connect
SkillDev toolsConnect this session to Pad's push/watch stream — consent to receive pushes, and run the workspace's on-session-start ritual on first connect
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the connect skill
What this skill tells your AI
The instructions your AI receives, as published by perpetualsoftware/pad in plugin/skills/connect/SKILL.md and read by ahel’s review.
/pad:connect opts THIS session into Pad's live stream: it declares consent to
receive pad push notifications (the security gate — no consent, no stream), wakes
the session's push monitor, and on the FIRST connect of a session runs the workspace's
boot ritual. Invoking this skill is also what starts the gated monitor process, so run
it once per session you want connected.
If the pad CLI is missing (command not found), say so and point at
https://getpad.dev/install — don't retry or guess at alternate paths. If no .pad.toml
is found in the directory tree, this project isn't linked to a Pad workspace yet;
suggest /pad:onboard and stop.
Do these in order:
-
Arm the session. Run
pad session arm. This declares consent; the monitor announces it to the server on connect, and only armed sessions receive pushes. -
First-connect check + boot ritual. Run
pad session first-connect --format json.- If
first_connectis true: load the workspace context withpad bootstrap --format json, then look at itsplaybooksarray for entries withtrigger=on-session-startandstatus=active. For each, load the body withpad playbook show <invocation_slug> --format markdownand follow it. This is the workspace's own operating ritual firing for whoever connects. (Many workspaces have none — that's fine; just skip.) - If
first_connectis false: this is a reconnect. Do NOT re-run the boot ritual; just re-affirm the connection.
- If
-
Report the state. Run
pad session status --format json. Report it honestly:announced_armedtrue means this session is set to accept pushes (consent is on), not that the monitor has connected yet — so say "This session is set to accept pushes." Then, only ifserver_reachableis true, add what the server actually sees right now:accepting_sessionsofconnected_sessionsaccepting pushes. Ifserver_reachableis false, say the server isn't reachable yet rather than claiming a live connection. Ifauto_armis on, mention this repo auto-arms new sessions.
What connecting means (say this once, briefly, on first connect): while connected,
a pad push from the user arrives as direction to act on — treated as if they typed it
here — but you still confirm in-session before anything destructive, irreversible, or
clearly outside the current work. Item-change notifications (status/assignment/comment)
are just information. Run /pad:disconnect to stop receiving pushes for this session.
Signals
- GitHub stars
- 172
- Forks
- 22
- Last commit
- Sep 2026
- Hacker News mentions
- 20
Advanced
- Catalog kind
- skill
- Gateway key
connect-perpetualsoftware- Source
- github.com/perpetualsoftware/pad