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"
    }
  }
}

maxAge

"7d"

"24h"

maxCount

100

50

minRetention

"1d"

"12h"

Session Limits

Configure turn limits:

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

Session Storage

Sessions are stored in:

~/.gemini/tmp/<project_hash>/

Command Line Options

--resume

-r

--list-sessions

--delete-session <id>

Keyword Registry (Delegates to gemini-cli-docs)

--resume flag

resume session

/resume command

session browser

search sessions

/resume interactive

sessionRetention

maxAge maxCount

session cleanup

maxSessionTurns

session limits

turn limits

session storage

~/.gemini/tmp

session location

--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

• "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