obsidian-plugin/rait-09_obsidian-agent-client
1
0
Fork 0
mirror of https://github.com/rait-09/obsidian-agent-client.git synced 2026-07-22 16:30:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
rait-09_obsidian-agent-client/docs/usage/session-manager.md

3.9 KiB
Raw Permalink Blame History

Session Manager

A dedicated sidebar view that lists all open chat sessions with live status, so you can keep track of multiple conversations at a glance.

Session Manager view in the left sidebar

Overview

The Session Manager shows every chat view currently open — sidebar, floating, and embedded chat blocks — with:

  • Session title — derived from the first message, or the saved title if you renamed it
  • Agent name — which agent the session is using. Embedded chat blocks are tagged with an embedded badge
  • Status icon — live indicator of what the session is doing right now
  • Focus highlight — the currently focused chat view is marked as active

::: tip This is especially useful when you have many chat views open and want to see which one is generating, awaiting permission, or idle. :::

::: info Embedded chats come and go with their note An embedded chat is listed only while its host note is open and the block is rendered. Closing the note removes the entry from this list — the conversation itself stays available in Session History. :::

Opening the Session Manager

You can open the Session Manager in several ways:

  • Chat header menu: Click the ⋮ (more) menu in any chat view's header and select "Open session manager"
  • Command palette: Open Cmd/Ctrl + P and search for "Open session manager"

The view opens in the left sidebar by default. You can drag it to a different location like any other Obsidian view.

::: tip Assign a keyboard shortcut to "Open session manager" in Settings → Hotkeys for quick access. :::

Status Icons

Each session entry shows an icon reflecting its current state:

Icon Status Meaning
Ready Ready The session is connected and idle, waiting for your next message
Busy Busy The agent is processing or generating a response
Permission Permission The agent is waiting for you to approve or reject an action
Error Error The session encountered an error

Actions

Switch to a Session

Click any session entry to focus that chat view. Sidebar views are revealed by Obsidian, floating windows are brought to the front, and embedded chat blocks bring their host note forward, scroll to the block, and focus the chat input.

Session Menu

Click the ⋮ (more) button on the right of any session entry, or right-click the entry, to open the action menu:

Session entry context menu showing Rename and Close

Action Description
Rename Edit the session title. The new title is shown both in the Session Manager and on the chat view's tab
Close Close the chat view (the underlying session remains in History)

For embedded chat blocks, only Rename is offered. There is no Close action — the view is owned by the code block in its host note, so close the note (or remove the block) instead.

::: tip Renaming is also available from the chat header (⋮ menu → Rename session) and from Session History. :::

Empty State

If no chat views are open, the Session Manager shows "No active sessions". Open a chat view (ribbon icon or the "Open chat view" command) to populate the list.

See Also