promptgarten ๐ŸŒฑ

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

MORE COMMANDS ยท Cursor CLI

agent resumeagent create-chatagent generate-rule | agent ruleagent install-shell-integrationagent uninstall-shell-integrationagent help [command]agent mcp login <identifier>agent mcp listagent mcp list-tools <identifier>agent mcp enable <identifier>agent mcp disable <identifier>agent sandbox enable

All commands ยท Cursor CLI โ†’

Share:๐•in๐Ÿ’ฌ