Command reference ยท Cursor CLI
agent ls
Opens a list of previous chats to pick one to resume.
agent ls is a terminal subcommand and is called directly in the shell, without a session needing to be running first. According to the reference, the official description is simply "Resume a chat session" โ despite the name ls, it doesn't list files, but offers previous chat sessions for selection, which you then resume. Since an update in June 2026, agent ls, the --resume flag, and the /resume slash command ("Open recent chats and resume one") all open the same list by default: all chats across all workspaces, no longer just those of the current directory. There is no dedicated /ls slash command; /resume is the closest interactive counterpart. If instead you want to resume the most recently used session directly without a selection list, agent resume or the global --continue flag is the shorter path.
โ WHEN TO USE IT?
Uncertain which session to pick
Run agent ls when it's unclear which of the recent sessions to resume
Find a chat from another workspace
Open agent ls to find a session from a different project directory again
โ WHEN NOT TO?
Resume the most recently used session directly
agent ls first shows a selection list, which means an extra step.
Better: Use agent resume or the global --continue flag to resume the last session directly
SOURCES
- Cursor Docs โ CLI Reference: Parameters โ cursor.com
MORE COMMANDS ยท Cursor CLI