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

```bash
gemini --resume
# or
gemini -r
```

### Resume via Browser

In an active session:

```text
/resume
```

Opens interactive session browser to search and select.

## Session Retention

Configure automatic cleanup in `settings.json`:

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

```json
{
  "general": {
    "maxSessionTurns": 100
  }
}
```

## Session Storage

Sessions are stored in:

```text
~/.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 comma