Navigating Between Sessions

As you start running more agents across more folders, you’ll want efficient ways to jump between them. The Cosine CLI gives you several ways to do this.

Resuming a Previous Session

Press / or Ctrl+P to open the commands menu, then select Resume a session. For a full list of keyboard shortcuts, see Navigating the CLI. This lets you search through your previous sessions by name and jump back into any of them — instantly restoring the same folder, files, and conversation context.

You don’t need to navigate your terminal to the right folder first. Resuming a session puts you back in the exact directory you were in when you last worked on it.

Changing Your Working Directory

If you want to open the CLI in a specific folder without leaving your current terminal, use the CWD (current working directory) feature. Drag a folder from Finder (macOS) or your file manager directly into the CLI prompt — it will pre-fill the path for you.

Alternatively, use standard terminal navigation:

cd ~/my-project
cos

Opening Multiple Agent Windows

You can open multiple CLI windows at the same time, each pointing to a different folder. This is particularly useful when:

One agent is doing a long research task while you want to start something new.
You’re working in the same folder with two different models for different perspectives.
You’re handing off context from one agent to another (see Sharing Context Between Agents).

Within a single CLI session, press Ctrl+T to open a new terminal tab directly inside the interface.

Don’t Delete Your History Files

Your session history is stored in a special .cosine folder. Even if you uninstall and reinstall the CLI, do not delete this folder — it contains all your session history and stored context, which is what makes your agents feel persistent and knowledgeable over time.

Key Takeaways

Use the commands menu (/ or Ctrl+P) → Resume a session to jump back to any previous conversation.
Drag a folder into the CLI to quickly change your working directory.
Run multiple CLI windows in parallel — each can work in a different folder or with a different model.
Never delete your history files.

Next: Using agent.md to Define Agent Personas