johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Remove deprecated SessionBeacon and document seance (gt-zi83f, gt-kaox7)

Browse Source 
- Remove unused SessionBeacon function from session/names.go
- Add gt seance commands to reference.md Sessions section
- Document StartupNudge format for session discovery

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
gastown/crew/gus
2025-12-31 12:27:32 -08:00
committed by Steve Yegge
parent 3086927764
commit 2fecc45c7a
2 changed files with 11 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/reference.md
View File

@@ -257,8 +257,18 @@ gt handoff --shutdown # Terminate (polecats)
gt session stop <rig>/<agent> gt session stop <rig>/<agent>
gt peek <agent> # Check health gt peek <agent> # Check health
gt nudge <agent> "message" # Send message to agent gt nudge <agent> "message" # Send message to agent
gt seance # List discoverable predecessor sessions
gt seance --talk <id> # Talk to predecessor (full context)
gt seance --talk <id> -p "Where is X?" # One-shot question
``` ```
**Session Discovery**: Each session has a startup nudge that becomes searchable
in Claude's `/resume` picker:
```
[GAS TOWN] recipient <- sender • timestamp • topic[:mol-id]
```
Example: `[GAS TOWN] gastown/crew/gus <- human • 2025-12-30T15:42 • restart`
**IMPORTANT**: Always use `gt nudge` to send messages to Claude sessions. **IMPORTANT**: Always use `gt nudge` to send messages to Claude sessions.
Never use raw `tmux send-keys` - it doesn't handle Claude's input correctly. Never use raw `tmux send-keys` - it doesn't handle Claude's input correctly.
`gt nudge` uses literal mode + debounce + separate Enter for reliable delivery. `gt nudge` uses literal mode + debounce + separate Enter for reliable delivery.

24
internal/session/names.go
View File

@@ -1,10 +1,7 @@
// Package session provides polecat session lifecycle management. // Package session provides polecat session lifecycle management.
package session package session
import ( import "fmt"
"fmt"
"time"
)
// Prefix is the common prefix for all Gas Town tmux session names. // Prefix is the common prefix for all Gas Town tmux session names.
const Prefix = "gt-" const Prefix = "gt-"
@@ -39,25 +36,6 @@ func PolecatSessionName(rig, name string) string {
return fmt.Sprintf("%s%s-%s", Prefix, rig, name) return fmt.Sprintf("%s%s-%s", Prefix, rig, name)
} }
// SessionBeacon generates an identity beacon message for Claude Code sessions.
// This beacon becomes the session title in /resume picker, enabling workers to
// find their predecessor sessions.
//
// Format: [GAS TOWN] <address> • <mol-id or "ready"> • <timestamp>
//
// Examples:
// - [GAS TOWN] gastown/crew/max • gt-abc12 • 2025-12-30T14:32
// - [GAS TOWN] gastown/polecats/Toast • ready • 2025-12-30T09:15
// - [GAS TOWN] deacon • patrol • 2025-12-30T08:00
func SessionBeacon(address, molID string) string {
if molID == "" {
molID = "ready"
}
// Use local time in a compact format
timestamp := time.Now().Format("2006-01-02T15:04")
return fmt.Sprintf("[GAS TOWN] %s • %s • %s", address, molID, timestamp)
}
// PropulsionNudge generates the GUPP (Gas Town Universal Propulsion Principle) nudge. // PropulsionNudge generates the GUPP (Gas Town Universal Propulsion Principle) nudge.
// This is sent after the beacon to trigger autonomous work execution. // This is sent after the beacon to trigger autonomous work execution.
// The agent receives this as user input, triggering the propulsion principle: // The agent receives this as user input, triggering the propulsion principle: