session-management

Manage agent sessions including initialization, handoffs, revival (seance), and persistent identity for Polecats and Crew agents.

509 stars

Best use case

session-management is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Manage agent sessions including initialization, handoffs, revival (seance), and persistent identity for Polecats and Crew agents.

Teams using session-management should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/session-management/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/gastown/skills/session-management/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/session-management/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How session-management Compares

Feature / Agentsession-managementStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Manage agent sessions including initialization, handoffs, revival (seance), and persistent identity for Polecats and Crew agents.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Session Management

## Overview

Manage agent sessions in Gas Town: initialize new sessions, handle handoffs between agents, revive dead sessions (seance), and maintain persistent identity across ephemeral Polecat sessions.

## When to Use

- Initializing new agent sessions
- Handing off work between agents
- Reviving a dead or stuck agent session
- Managing Polecat identity persistence across sessions

## Session Operations

1. **Init**: Start new session with role and hook setup
2. **Attach**: Connect agent to Mayor for coordination
3. **Handoff**: Transfer work between agents with context
4. **Seance**: Revive a dead agent's session state
5. **Resume**: Continue from last checkpoint

## Agent Session Types

- **Crew**: Long-lived sessions, full state persistence
- **Polecat**: Ephemeral sessions, persistent identity, state via hooks
- **Dog**: Infrastructure sessions, minimal state

## Key Commands

- `gt mayor attach` - Attach to Mayor coordination
- `gt handoff` - Hand off work to another agent
- `gt seance` - Revive dead session
- `gt prime` - Prime agent with context

## Tool Use

Used within agent coordination and patrol monitoring processes.

Related Skills

translation-management

509
from a5c-ai/babysitter

Integration with translation management systems and i18n workflows. Connect with Crowdin, Transifex, Weblate, manage translation memory, synchronize glossaries, and automate localization pipelines.

key-management-orchestrator

509
from a5c-ai/babysitter

Cryptographic key lifecycle management orchestration including generation, rotation, and destruction across key management systems

ip-core-management

509
from a5c-ai/babysitter

Vendor IP core configuration and integration expertise for FPGA designs

donor-relationship-management

509
from a5c-ai/babysitter

Cultivate and steward donor relationships including prospect research, personalized engagement strategies, gift acknowledgment, and impact reporting

change-management

509
from a5c-ai/babysitter

Skill for engineering change request and order processing through PLM systems

stormwater-management

509
from a5c-ai/babysitter

Skill for integrated stormwater management and green infrastructure design with SWMM modeling, hydrologic analysis, BMP sizing, and MS4 permit compliance.

thermal-management

509
from a5c-ai/babysitter

Vehicle and powertrain thermal management system design

influencer-kol-management

509
from a5c-ai/babysitter

Industry influencer and key opinion leader relationship management

crisis-management-platform

509
from a5c-ai/babysitter

Crisis response platform integration and real-time monitoring

social-media-management

509
from a5c-ai/babysitter

Cross-platform social media operations and analytics

marketing-project-management

509
from a5c-ai/babysitter

Marketing workflow and project management integration

content-management

509
from a5c-ai/babysitter

CMS operations and content optimization tools