Working on multiple projects or tasks can be challenging, especially when each one has a different conversation context. ChatCLI solves this with a simple and powerful session management system.
A session is essentially a complete “save” of your conversation history, allowing you to resume exactly where you left off.
ChatCLI uses a unified history — a single message array shared across all modes (chat, agent, coder). When saving a session, the entire context is preserved regardless of the mode in which it was generated. Use /compact to reduce size and /rewind to go back to earlier points.
Session Commands
All session management commands start with /session.
/session save <name>
Saves the current conversation (the entire history of prompts and responses) with a name of your choice./session save debug-api-pagamentos
Sessão 'debug-api-pagamentos' salva com sucesso.
After saving, the session name will appear in your prompt (e.g., debug-api-pagamentos), indicating that you are working within that session.
/session load <name>
Loads a previously saved session. The current conversation is replaced by the loaded session’s history./session load documentação-site
Sessão 'documentação-site' carregada. A conversa anterior foi restaurada.
/session list
Lists all sessions you have saved to disk.Sessões salvas:
- debug-api-pagamentos
- documentação-site
- refatoração-legado
/session delete <name>
Permanently removes a saved session from disk. This action cannot be undone./session delete refatoração-legado
Sessão 'refatoração-legado' deletada com sucesso do disco.
If you delete the currently active session, your current history will be cleared and you will start a new conversation.
/session new (or /newsession)
Clears the current history and starts a completely new conversation. Perfect for starting a task from scratch without being tied to any named session.Nova sessão de conversa iniciada; histórico foi limpo.
Next Steps
