DEEN

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?

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

CommandWhat it does
/forkBranch the conversation and try another way
/rewindGo back to an earlier point
/editEdit an earlier message and continue from there
/retryResend the last message after a failed answer
/historyBrowse the session's history

Keep it tidy

CommandWhat it does
/renameRename the session
/archiveArchive the session
/compactShorten the conversation to free context
/exportExport the session as Markdown
/copyCopy the last answer as Markdown
/transcriptBrowse 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.