Skip to content

fix(pilotctl,install): stop claiming pilot-gateway ships with the install #355

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

Merged
TeoSlayer merged 1 commit into from
Jul 7, 2026
Merged

fix(pilotctl,install): stop claiming pilot-gateway ships with the install #355

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
16 changes: 10 additions & 6 deletions cmd/pilotctl/main.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1567,9 +1567,11 @@ Config file: ~/.pilot/config.json

Companion binaries:
daemon start / start --foreground exec the separately-shipped
pilot-daemon binary; gateway start / map exec pilot-gateway. They
are discovered (in order): $PILOT_DAEMON_BIN / $PILOT_GATEWAY_BIN,
next to the pilotctl executable, then $PATH.
pilot-daemon binary; gateway start / map exec pilot-gateway
(optional — no longer ships in release tarballs; build it from
github.com/pilot-protocol/gateway). Both are discovered (in order):
$PILOT_DAEMON_BIN / $PILOT_GATEWAY_BIN, next to the pilotctl
executable, then $PATH.
`)
os.Exit(2)
}
Expand Down Expand Up @@ -2095,7 +2097,7 @@ func cmdConfig(args []string) {
func contextCatalog() map[string]interface{} {
return map[string]interface{}{
"version": "1.4",
"note": "Core commands cover everything an agent needs. 'app_store' lists the 'pilotctl appstore <sub>' command family (install + call local capability apps). Use 'pilotctl extras <cmd>' for operator/admin operations. 'pilot-gateway' is a separate installed binary.",
"note": "Core commands cover everything an agent needs. 'app_store' lists the 'pilotctl appstore <sub>' command family (install + call local capability apps). Use 'pilotctl extras <cmd>' for operator/admin operations. 'pilot-gateway' is an optional companion binary (not shipped in release tarballs; build from github.com/pilot-protocol/gateway).",

// ── Core agent commands ──────────────────────────────────────────────
"commands": map[string]interface{}{
Expand Down Expand Up @@ -2361,7 +2363,7 @@ func contextCatalog() map[string]interface{} {
// ── pilot-gateway binary ─────────────────────────────────────────────
"pilot_gateway": map[string]interface{}{
"binary": "pilot-gateway",
"description": "IP gateway — bridges standard TCP/IP applications to Pilot Protocol addresses. Separate binary installed alongside pilotctl.",
"description": "IP gateway — bridges standard TCP/IP applications to Pilot Protocol addresses. Optional companion binary: not shipped in release tarballs, build from github.com/pilot-protocol/gateway.",
"commands": map[string]interface{}{
"start": map[string]interface{}{
"args": []string{"[--subnet <cidr>]", "[--ports <list>]", "[<pilot-addr>...]"},
Expand Down Expand Up @@ -2597,7 +2599,9 @@ func daemonBinaryPath() string {
func gatewayBinaryPath() string {
path, err := findCompanionBinary("pilot-gateway", "PILOT_GATEWAY_BIN")
if err != nil {
fatalCode("internal", "%v", err)
fatalHint("not_found",
"pilot-gateway no longer ships in release tarballs — build it from github.com/pilot-protocol/gateway, place it next to pilotctl or on $PATH, or set PILOT_GATEWAY_BIN",
"%v", err)
}
return path
}
Expand Down
8 changes: 5 additions & 3 deletions docs/cli-reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,9 @@ Config file: ~/.pilot/config.json

Companion binaries:
daemon start / start --foreground exec the separately-shipped
pilot-daemon binary; gateway start / map exec pilot-gateway. They
are discovered (in order): $PILOT_DAEMON_BIN / $PILOT_GATEWAY_BIN,
next to the pilotctl executable, then $PATH.
pilot-daemon binary; gateway start / map exec pilot-gateway
(optional — no longer ships in release tarballs; build it from
github.com/pilot-protocol/gateway). Both are discovered (in order):
$PILOT_DAEMON_BIN / $PILOT_GATEWAY_BIN, next to the pilotctl
executable, then $PATH.
```
15 changes: 10 additions & 5 deletions install.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -708,11 +708,16 @@ echo " pilotctl daemon start --hostname my-agent # email already saved"
echo " pilotctl info"
echo " pilotctl ping <other-agent>"
echo ""
echo "Bridge IP traffic (requires root for ports < 1024):"
echo ""
echo " sudo ${BIN_DIR}/pilotctl gateway start --ports 80,3000 <pilot-addr>"
echo " curl http://10.4.0.1:3000/status"
echo ""
# pilot-gateway no longer ships in release tarballs (extracted to the
# sibling pilot-protocol/gateway repo) — only show the bridge hint when
# the binary actually exists on this host.
if [ -f "$BIN_DIR/pilot-gateway" ]; then
echo "Bridge IP traffic (requires root for ports < 1024):"
echo ""
echo " sudo ${BIN_DIR}/pilotctl gateway start --ports 80,3000 <pilot-addr>"
echo " curl http://10.4.0.1:3000/status"
echo ""
fi
echo "Agent skill auto-injection:"
echo ""
echo " The daemon scans every 15 minutes and injects the Pilot Protocol"
Expand Down
Loading