DocsWorking with Alran
Sessions
Every conversation is a session, saved on your machine. Resume it, branch it, rewind it, export it.
How do I resume a session?
alran --continue # the latest session in this folder
alran --session # browse sessions
alran --session <id> # open one by idInside the TUI, /sessions searches, resumes and manages sessions. /new starts a fresh one.
Change 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
| 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
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.