/gobby-sessions - Session Management Skill

This skill manages agent sessions via the gobby-sessions MCP server. Parse the user's input to determine which subcommand to execute.

Session Context

IMPORTANT: Use the session_id from your SessionStart hook context for most calls. Look for it in your system context:

session_id: fd59c8fc-...

Subcommands

/gobby-sessions list - List all sessions

Call gobby-sessions.list_sessions with:

• limit: Max results (default 20)
• status: Filter by status (active, ended)
• source: Filter by source (claude, gemini, codex)
• project_id: Optional project scope

Returns recent sessions with ID, source, start time, and status.

Example: /gobby-sessions list → list_sessions(limit="20") Example: /gobby-sessions list active → list_sessions(status="active") Example: /gobby-sessions list claude → list_sessions(source="claude")

/gobby-sessions show <session-id> - Show session details

Call gobby-sessions.get_session with:

• session_id: (required) The session ID to retrieve

Returns full session details including:

• Session metadata (source, times, duration)
• Tool calls made
• Tasks worked on
• Summary if available

Example: /gobby-sessions show → get_session(session_id="<current session_id>") Example: /gobby-sessions show sess-abc123 → get_session(session_id="sess-abc123")

/gobby-sessions messages <session-id> - Get session messages

Call gobby-sessions.get_session_messages with:

• session_id: (required) Session ID
• limit: Max messages to return
• offset: Skip first N messages
• full_content: Include full message content (default truncated)

Returns conversation messages from a session.

Example: /gobby-sessions messages → get_session_messages(session_id="<current session_id>")

/gobby-sessions search <query> - Search messages

Call gobby-sessions.search_messages with:

• query: (required) Search query (uses FTS)
• session_id: Optional - scope to specific session
• limit: Max results
• full_content: Include full message content

Searches message content using Full Text Search.

Example: /gobby-sessions search authentication bug → search_messages(query="authentication bug") Example: /gobby-sessions search error --session=sess-abc123 → search_messages(query="error", session_id="sess-abc123")

/gobby-sessions handoff - Create session handoff

Call gobby-sessions.create_handoff with:

• session_id: Optional (defaults to current session)
• notes: Optional notes to include
• compact: Generate compact markdown
• full: Generate full transcript
• write_file: Write to file
• output_path: Custom output path

Creates handoff context by extracting structured data from the session transcript.

Example: /gobby-sessions handoff → create_handoff() Example: /gobby-sessions handoff --notes="Continue with auth feature" → create_handoff(notes="Continue with auth feature")

/gobby-sessions get-handoff <session-id> - Get existing handoff

Call gobby-sessions.get_handoff_context with:

• session_id: (required) Session ID

Retrieves the handoff context (compact_markdown) for a session.

Example: /gobby-sessions get-handoff sess-abc123 → get_handoff_context(session_id="sess-abc123")

/gobby-sessions pickup [session-id] - Resume a previous session

Call gobby-sessions.pickup with:

• session_id: Optional specific session ID (defaults to most recent)
• source: Filter by source (claude, gemini, codex)
• project_id: Optional project scope
• link_child_session_id: Link this session as child

Retrieves and injects handoff context from a previous session.

Example: /gobby-sessions pickup → pickup() (resumes most recent) Example: /gobby-sessions pickup sess-abc123 → pickup(session_id="sess-abc123")

/gobby-sessions commits <session-id> - Get session commits

Call gobby-sessions.get_session_commits with:

• session_id: (required) Session ID
• max_commits: Max commits to return

Returns git commits made during the session timeframe.

Example: /gobby-sessions commits → get_session_commits(session_id="<current session_id>")

/gobby-sessions stats - Get session statistics

Call gobby-sessions.session_stats with:

• project_id: Optional project scope

Returns session statistics for the project.

Example: /gobby-sessions stats → session_stats()

/gobby-sessions mark-complete - Mark loop complete

Call gobby-sessions.mark_loop_complete to mark the autonomous loop as complete, preventing session chaining.

Example: /gobby-sessions mark-complete → mark_loop_complete()

Response Format

After executing the appropriate MCP tool, present the results clearly:

• For list: Table with session ID, source, start time, duration, status
• For show: Full session details in readable format
• For messages: Formatted conversation history
• For search: Matching messages with context
• For handoff/create_handoff: Confirm handoff context was prepared, show summary
• For get-handoff: Show stored handoff context
• For pickup: Show injected context, highlight key continuation points
• For commits: List commits with SHA, message, and timestamp
• For stats: Session statistics summary
• For mark-complete: Confirmation

Session Concepts

• Session: A single agent conversation (Claude Code, Gemini CLI, or Codex)
• Handoff: Context preservation across sessions via /compact
• Pickup: Resuming work from a previous session's context
• Source: Which CLI tool created the session

Error Handling

If the subcommand is not recognized, show available subcommands:

• list, show, messages, search, handoff, get-handoff, pickup, commits, stats, mark-complete