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
RAIT-09 a1a3ab60d3 docs(usage): add Session Manager and Prompt Injection pages 
- Session Manager: explain the dedicated sidebar view that lists
  open chat sessions with live status icons, how to open it (chat
  header menu or command palette), the four status icons, and the
  Rename/Close actions
- Prompt Injection: explain the first-message instructions that
  guide agents toward Obsidian-flavored Markdown (wikilinks,
  LaTeX math, table spacing), with the actual injected strings
  for reference
- Add both pages to the VitePress sidebar under Usage
- Add screenshots: Session Manager view, context menu, four
  status icons, and the Prompt injection settings section
2026-05-22 18:44:04 +09:00

3.3 KiB
Raw 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 (sidebar and floating) currently open, with:

  • Session title — derived from the first message, or the saved title if you renamed it
  • Agent name — which agent the session is using
  • 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. :::

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. If the view is in the sidebar, Obsidian reveals it. If it is a floating window, it is brought to the front.

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)

::: 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