---
title: "Sessions · Alran Code Docs"
url: https://alran.dev/en/docs/sessions
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Working with Alran

# Sessions

Every conversation is a session, saved on your machine. Resume it, branch it, rewind it, export it.

On this page

[How do I resume a session?](#resume) [Change history](#history) [Keep it tidy](#tidy) [Common questions](#faq)

## How do I resume a session? {#resume}

```bash
alran --continue     # the latest session in this folder
alran --session      # browse sessions
alran --session <id> # open one by id
```

Inside the TUI, `/sessions` searches, resumes and manages sessions. `/new` starts a fresh one.

## Change history {#history}

| Command | What it does |
| `/fork` | Branch the conversation and try another way |
| `/rewind` | Go back to an earlier point |
| `/edit` | Edit an earlier message and continue from there |
| `/retry` | Resend the last message after a failed answer |
| `/history` | Browse the session's history |

## Keep it tidy {#tidy}

| Command | What it does |
| `/rename` | Rename the session |
| `/archive` | Archive the session |
| `/compact` | Shorten the conversation to free context |
| `/export` | Export the session as Markdown |
| `/copy` | Copy the last answer as Markdown |
| `/transcript` | Browse and search the full conversation |

Sessions live in the data folder (`~/.alran` by default) and never leave your machine on their own.

## Common questions {#faq}

How do I resume a session?

Run alran --continue for the latest session in the folder, alran --session to browse the sessions, or alran --session with the id of a session to open it. Inside the TUI, the command /sessions searches, resumes and manages your sessions.

Can I change an earlier message in a session?

The command /edit changes an earlier message and continues from there, /rewind goes back to an earlier point, /retry resends the last message after a failed answer and /fork branches the conversation to try another way.

Where are sessions stored and can I export one?

Sessions live in the data folder, by default ~/.alran, and never leave your machine on their own. The command /export writes the session as Markdown.

[PreviousSubagents and tasks](https://alran.dev/en/docs/subagents) [NextPlugins, skills and hooks](https://alran.dev/en/docs/plugins)
