# Gemini CLI resume session: --resume, /resume and history > Resume a Gemini CLI session with gemini --resume, an index or a session ID, or /resume inside it. Where history lives, and why it's gone after 30 days. Source: https://shuriken.sh/guides/gemini-cli-resume-session Run gemini --resume (or -r) to reopen the most recently started session for the folder you're in. gemini --list-sessions numbers the others, so gemini --resume 3 or a session UUID opens one of them; inside Gemini CLI, /resume opens a browser of past sessions. By Shuriken Updated 27 October 2026 6 min read **Contents** To resume a Gemini CLI session, cd into the project and run gemini --resume (short form gemini -r), which reopens the session started there most recently. For an older one, gemini --list-sessions prints a numbered list: pass the number (gemini --resume 3) or the full . Inside a running session, /resume opens a session browser. Commands checked on 24 October 2026 against v0.65.0, the latest stable release then, using Google's [session management page](https://geminicli.com/docs/cli/session-management/) and the source on GitHub. The two disagree on one point, the name of the project folder, and both versions are below. ## How to resume a Gemini CLI session # | Command | What it does | | --- | --- | | gemini --resume or gemini -r | The most recently started session in this project | | gemini -r latest | The same, spelled out | | gemini -r latest "Check for type errors" | Resumes it and sends a new prompt | | gemini --list-sessions | Lists this project's sessions with their numbers, then exits | | gemini --resume 3 | Session number 3 from that list | | gemini --resume | One session, by its full ID | | gemini --delete-session 3 | Deletes session number 3 | | /resume | Opens the session browser inside Gemini CLI | The numbers run oldest first: 1 is the first session you started in this project and the newest has the highest number ([sessionUtils.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/cli/src/utils/sessionUtils.ts)). So run --list-sessions before --delete-session, because number 1 is the oldest, not the latest. "Latest" goes by when a session started, not when you last used it. If you reopened an older session yesterday, gemini -r still picks the one that began most recently. --resume, --session-id and --session-file are mutually exclusive: Gemini CLI takes only one of them per start. ### The session browser # Typing /resume while Gemini CLI runs opens a list of this project's past sessions with the date, the number of messages and the first prompt of each. Press / to search by ID or by what was said, Enter to resume the highlighted one, x to delete it and Esc to close. /chat opens the same browser; it's an alias. ## Named checkpoints: /resume save and /chat save # Nothing needs saving before you quit, because Gemini CLI records every session as it goes. A checkpoint is different: a named copy of the conversation at one moment, for a point you may want to go back to. text /resume save before-refactor /resume list /resume resume before-refactor - /chat save, /chat list and /chat resume are the same three commands. - /resume load is another name for /resume resume . - /resume delete removes a checkpoint. - Saving under a tag that exists asks before it overwrites. - /resume share notes.md (or a .json name) writes the current conversation to that file. A checkpoint belongs to the project you saved it in. The [commands reference](https://geminicli.com/docs/reference/commands/) says you can only resume one from that same project, so start Gemini CLI in that folder first. The source writes it as checkpoint-.json in the project's folder under ~/.gemini/tmp/ ([logger.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/core/logger.ts)). ## Where Gemini CLI keeps session history # [chatRecordingService.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/services/chatRecordingService.ts) writes one file per session and names it from the start time in UTC, to the minute, plus the first 8 characters of the session ID: ~/.gemini/tmp//chats/session-2026-10-24T09-15-a1b2c3d4.jsonl If that name is already taken, a counter goes between the time and the ID. On Windows the folder is C:\Users\\.gemini\tmp\. Google lists what the file holds: your prompts and the replies, every tool call with its input and output, token counts, and the model's reasoning summaries when there are any. Google's page calls the project folder . In the current source it's your project folder's name, lowercased, with anything but letters and digits turned into dashes: ~/Code/My App becomes my-app, and a second project with the same name gets my-app-1. ~/.gemini/projects.json records which path owns which name, and a .project_root file inside the folder says the same ([projectRegistry.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/config/projectRegistry.ts)). Older versions used a SHA-256 hash of the path, and Gemini CLI moves those folders to the new names when it next opens the project. History is per project. Run gemini -r in ~/Code/other-app and it reads other-app's chats folder, never this one's. GEMINI_CLI_HOME moves the whole tree: with it set, everything lives in $GEMINI_CLI_HOME/.gemini/ ([configuration reference](https://geminicli.com/docs/reference/configuration/)). ## Why Gemini CLI deletes sessions after 30 days # Since v0.33.0, released on 11 March 2026, Gemini CLI cleans up old history by default ([release notes](https://geminicli.com/docs/changelogs/)). Each time it starts, it deletes sessions in the current project whose last update is more than 30 days old, along with their plans, tool output and logs. Four settings in settings.json control it: | Setting | Default | What it does | | --- | --- | --- | | general.sessionRetention.enabled | true | Turns the cleanup on or off | | general.sessionRetention.maxAge | "30d" | Deletes sessions not updated for this long | | general.sessionRetention.maxCount | none | Keeps only this many of the most recent sessions | | general.sessionRetention.minRetention | "1d" | Never deletes anything newer than this | To keep a year of history, put this in ~/.gemini/settings.json: json { "general": { "sessionRetention": { "maxAge": "365d" } } } Units are h, d, w and m (a 30-day month). Set "enabled": false to keep everything. In /settings the same two are Enable Session Cleanup and Keep chat history (that one is maxAge). A maxAge shorter than minRetention is invalid, and Gemini CLI then skips the cleanup altogether. Three details from [sessionCleanup.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/cli/src/utils/sessionCleanup.ts). The cleanup only looks at the project you start Gemini CLI in, so a project you haven't opened for two months still has its old sessions until you open it. It also deletes session files it can't read. And it reads only the chats folder, so tagged checkpoints sit outside it and are left alone. Claude Code has the same 30-day default under another name, cleanupPeriodDays ([Claude Code deleted your old chats?](https://shuriken.sh/guides/claude-code-history-deleted-after-30-days)). Shuriken runs Claude Code, Codex, Gemini CLI and 64 more agents side by side, with your own sign-ins. [Download](https://shuriken.sh/download) ## Why a session doesn't come back # gemini --resume says "No previous sessions found for this project." or "Invalid session identifier" for one of these reasons: - Another folder. Sessions are per project. cd back to where you started it. - Another GEMINI_CLI_HOME. A session started with GEMINI_CLI_HOME=~/gemini-work is in ~/gemini-work/.gemini/tmp/, and plain gemini won't list it. - The 30-day cleanup. Once deleted, it's gone. Raise maxAge now so the rest stay. - The macOS Seatbelt sandbox. When it runs inside sandbox-exec, Gemini CLI keeps its history in ~/.cache/.gemini/ instead, because the sandbox profile blocks writes to ~/.gemini ([storage.ts](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/config/storage.ts)). - A wrong number. The index counts from the oldest session, and it shifts when sessions are deleted. Run --list-sessions again. ## Resuming on another Google account # Since 18 June 2026, Gemini CLI no longer serves Google AI Pro and Ultra sign-ins, or people on the free Gemini Code Assist for individuals. [Google's announcement](https://developers.googleblog.com/en/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) says Code Assist Standard and Enterprise licences keep working, and that Gemini CLI "will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys". If that's how you sign in, history and resume work as above. Signing out and back in as another account inside one ~/.gemini keeps the history, because it's stored per project, not per account. People who keep each account in its own GEMINI_CLI_HOME split their history too: each home has its own tmp. The fix is to link tmp from ~/.gemini into each home before its first run, along with GEMINI.md, commands, extensions and skills, never the sign-in files; [changing Google account in Gemini CLI](https://shuriken.sh/guides/gemini-cli-change-google-account) has the commands. Gemini CLI then finds the project's folder again through its .project_root file. Use only accounts and keys you own and are entitled to use; providers' terms may not allow sharing a subscription sign-in. The Claude Code and Codex versions of this have different commands and folders: [resuming a Claude Code session](https://shuriken.sh/guides/resume-claude-code-session) and Codex CLI resume. ## How Shuriken keeps Gemini chats going # In Shuriken, a Gemini CLI chat is a chat in a project. It's saved where it runs and opens from any device you've linked, so there's no session number or ID to look up. Every Google sign-in you add as a source gets its own GEMINI_CLI_HOME, and Shuriken links tmp from your ~/.gemini into each one, with GEMINI.md, commands, extensions and skills. Every sign-in writes its sessions into the same folder, so the second reason above doesn't apply. With two or more Gemini sources, Shuriken switches between them. Hot swapping is our name for it: Shuriken moves your chats to another of your accounts or sources when one nears its limit. A Gemini chat moves when its current turn ends, and the next turn picks up the same conversation on the new source. [Source switching](https://shuriken.sh/features/source-switching) has the settings. Shuriken runs the same Gemini CLI, so a Google AI Pro, Ultra or free sign-in fails there just as it does in your terminal. If you hold a Code Assist licence or a paid Gemini API key, [download Shuriken](https://shuriken.sh/download) and add it as a source. Share [X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fgemini-cli-resume-session&text=Gemini%20CLI%20resume%20session%3A%20--resume%2C%20%2Fresume%20and%20history)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fgemini-cli-resume-session)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fguides%2Fgemini-cli-resume-session&t=Gemini%20CLI%20resume%20session%3A%20--resume%2C%20%2Fresume%20and%20history)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fgemini-cli-resume-session&title=Gemini%20CLI%20resume%20session%3A%20--resume%2C%20%2Fresume%20and%20history)[E-mail](mailto:?subject=Gemini%20CLI%20resume%20session%3A%20--resume%2C%20%2Fresume%20and%20history&body=https%3A%2F%2Fshuriken.sh%2Fguides%2Fgemini-cli-resume-session) ## Sources - [Gemini CLI docs: Session management](https://geminicli.com/docs/cli/session-management/) (accessed 24 October 2026) - [Gemini CLI docs: Commands reference (/resume, /chat)](https://geminicli.com/docs/reference/commands/) (accessed 24 October 2026) - [Gemini CLI docs: CLI cheatsheet (gemini -r "latest")](https://geminicli.com/docs/cli/cli-reference/) (accessed 24 October 2026) - [Gemini CLI docs: Configuration (GEMINI_CLI_HOME)](https://geminicli.com/docs/reference/configuration/) (accessed 24 October 2026) - [Gemini CLI docs: Release notes (v0.33.0, 30-day default retention)](https://geminicli.com/docs/changelogs/) (accessed 24 October 2026) - [Gemini CLI docs: Latest stable release, v0.65.0](https://geminicli.com/docs/changelogs/latest/) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: sessionUtils.ts (resume order and latest)](https://github.com/google-gemini/gemini-cli/blob/main/packages/cli/src/utils/sessionUtils.ts) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: sessionCleanup.ts (what the 30-day cleanup deletes)](https://github.com/google-gemini/gemini-cli/blob/main/packages/cli/src/utils/sessionCleanup.ts) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: projectRegistry.ts (project folder names)](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/config/projectRegistry.ts) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: storage.ts (tmp folder, sandbox location)](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/config/storage.ts) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: chatRecordingService.ts (session file names)](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/services/chatRecordingService.ts) (accessed 24 October 2026) - [google-gemini/gemini-cli on GitHub: logger.ts (checkpoint files)](https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/core/logger.ts) (accessed 24 October 2026) - [Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI](https://developers.googleblog.com/en/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) (accessed 24 October 2026) ## Frequently asked questions **How do I resume my last Gemini CLI session?** Run gemini --resume in the same project folder. With no value, or with latest, it loads the session that was started most recently there. gemini -r latest "your prompt" resumes it and sends a new prompt. **Where does Gemini CLI store chat history?** In ~/.gemini/tmp//chats/, one session-….jsonl file per session. Google's docs call the folder ; current versions name it after your project folder. GEMINI_CLI_HOME moves the whole .gemini folder. **Why are my Gemini CLI sessions deleted after 30 days?** Since v0.33.0 Gemini CLI deletes sessions whose last update is more than 30 days old, when it starts in that project. Raise general.sessionRetention.maxAge in settings.json, or set enabled to false to keep everything. **What is the difference between /resume and /chat save?** /resume on its own browses the sessions Gemini CLI recorded by itself in the chats folder. /resume save before-refactor (or /chat save before-refactor) writes a named checkpoint of the current conversation, and /resume resume before-refactor loads it later, in the same project only. **Why does gemini --resume say no previous sessions found?** It only looks at the project you started it in. Run it from the session's original folder, and with the same GEMINI_CLI_HOME; check that the session wasn't removed by the 30-day cleanup. Every coding agent 67 coding agents, one harness. Run Claude Code, Codex, Gemini CLI and the rest on your own computers, with the sign-ins you already have. [Download](https://shuriken.sh/download) [Other platforms](https://shuriken.sh/download#main) ## Keep reading - [Multiple accounts in every coding agent CLI: a reference: Guide 27 Oct 2026 9 min read Multiple accounts in a coding agent CLI: Copilot, Amp and OpenCode 2 switch natively. Most others need a home folder per account, set by one variable.](https://shuriken.sh/guides/coding-agent-multiple-accounts) - ["Running scripts is disabled" for codex, claude or gemini: Guide 27 Oct 2026 4 min read codex.ps1 cannot be loaded because PowerShell blocks the .ps1 shim npm writes. Type codex.cmd, or allow RemoteSigned for your own Windows account.](https://shuriken.sh/guides/running-scripts-is-disabled-agent-cli) - [AGENTS.md vs CLAUDE.md: one file for every agent?: Comparison 27 Oct 2026 6 min read AGENTS.md vs CLAUDE.md: Codex reads AGENTS.md, Claude Code reads it when there is no CLAUDE.md or through @AGENTS.md, Gemini CLI once you list it.](https://shuriken.sh/compare/agents-md-vs-claude-md) ## Free tools - [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude) - [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)