gemini-session-management

Gemini Session Management

MANDATORY: Invoke gemini-cli-docs First

STOP - Before providing ANY response about Gemini sessions:

1. INVOKE gemini-cli-docs skill
2. QUERY for the specific session topic
3. BASE responses EXCLUSIVELY on official documentation loaded

Overview

Meta-skill for managing Gemini CLI sessions. Sessions preserve conversation history and can be resumed, searched, and configured with retention policies.

When to Use This Skill

Keywords: session, resume, /resume, session browser, retention, maxAge, maxCount, --list-sessions, --delete-session

Use this skill when:

• Resuming a previous session
• Configuring session retention
• Browsing past sessions
• Managing session storage
• Understanding session limits

Session Resume

Resume Last Session

gemini --resume
# or
gemini -r

Resume via Browser

In an active session:

/resume

Opens interactive session browser to search and select.

Session Retention

Configure automatic cleanup in settings.json:

{
  "general": {
    "sessionRetention": {
      "maxAge": "7d",
      "maxCount": 100,
      "minRetention": "1d"
    }
  }
}

Setting	Description	Example
maxAge	Maximum session age	"7d", "24h"
maxCount	Maximum sessions to keep	100, 50
minRetention	Minimum time before deletion	"1d", "12h"

Session Limits

Configure turn limits:

{
  "general": {
    "maxSessionTurns": 100
  }
}

Session Storage

Sessions are stored in:

~/.gemini/tmp/<project_hash>/

Command Line Options

Option	Description
--resume, -r	Resume last session
--list-sessions	List available sessions
--delete-session <id>	Delete specific session

Keyword Registry (Delegates to gemini-cli-docs)

Topic	Query Keywords
Resume	--resume flag, resume session, /resume command
Browser	session browser, search sessions, /resume interactive
Retention	sessionRetention, maxAge maxCount, session cleanup
Limits	maxSessionTurns, session limits, turn limits
Storage	session storage, ~/.gemini/tmp, session location
Management	--list-sessions, --delete-session, session management

Quick Decision Tree

What do you want to do?

1. Resume last session -> gemini --resume or gemini -r
2. Browse past sessions -> /resume in active session
3. Configure retention -> Edit sessionRetention in settings.json
4. List all sessions -> gemini --list-sessions
5. Delete session -> gemini --delete-session <id>
6. Set turn limits -> Configure maxSessionTurns

Best Practices

1. Regular cleanup: Configure retention to avoid disk bloat
2. Name sessions: Use descriptive prompts for easy browsing
3. Resume for context: Continue complex conversations
4. Delete sensitive: Remove sessions with sensitive data

Verification Checkpoint

• Did I invoke gemini-cli-docs skill?
• Did official documentation load?
• Is my response based EXCLUSIVELY on official docs?

Test Scenarios

Scenario 1: Resume Session

Query: "How do I resume my last Gemini CLI session?" Expected Behavior:

• Skill activates on "resume" or "session"
• Provides gemini --resume command Success Criteria: User receives resume command and /resume browser option

Scenario 2: Configure Retention

Query: "How do I limit Gemini session storage?" Expected Behavior:

• Skill activates on "retention" or "session storage"
• Delegates to gemini-cli-docs for sessionRetention settings Success Criteria: User receives settings.json configuration with maxAge/maxCount

Scenario 3: Delete Session

Query: "How do I delete old Gemini sessions?" Expected Behavior:

• Skill activates on "delete session" or "session management"
• Provides --delete-session command Success Criteria: User receives deletion workflow and list-sessions option

References

Query gemini-cli-docs for official documentation on:

• "session management"
• "session resume"
• "sessionRetention"

Version History

• v1.1.0 (2025-12-01): Added Test Scenarios section
• v1.0.0 (2025-11-25): Initial release