Documentation

Chat workspace

Understand every control in the SystemSculpt chat view, from the model switcher to the tool approval window.

Layout overview

The chat workspace combines message rendering, live streaming, and prompt management in one place. These cards map the main UI regions so you know where to look.

Header & message stream
Swap models, review the active system prompt, and watch responses stream in with token counts, code blocks, and tool output stacked in order.
  • Tap the model name in the chat header to switch providers or favorited models without leaving the thread.
  • The system prompt chip tells you if you are using a preset, a custom file, or agent mode.
  • Live token counters show how much of your quota each reply uses and link to a detailed breakdown.
Context drawer & processing timeline
Attach vault files, PDFs, Office docs, and transcripts. The processing timeline mirrors every stage the plugin runs through before the file is ready.
  • Drag-and-drop or use **Chat with File** to send a document through the queue instantly.
  • The timeline walks through validation, upload, processing, and context stages with clear status icons.
  • Open the Similar Notes side panel to drag embeddings suggestions into the context drawer.
Tool calling, MCP, and approvals
Agent mode exposes approved connectors (Model Context Protocol servers), safe file actions, and batched approvals directly in chat.
  • Batch approvals group related tool calls so you can approve or decline them in one review.
  • Manage individual MCP tools from Settings → Overview & Setup when advanced mode is enabled.
  • Resume prior agent sessions from chat history notes without losing connected tools.

Context drawer workflow

Adding files uses the same flow triggered by the Chat with File command. Every stage matches the timeline you see in the drawer.

  • The drawer shows previews, keeps context chips in sync, and gives you retry or remove actions.
  • Every file moves through queued → uploading → processing → context → ready with matching status icons in the timeline.
  • Vault links and uploads follow the folder rules you set under Settings → SystemSculpt → Files & Backup.
Timeline stages
Chips cycle through queued, uploading, processing, context, and ready—the same milestones the Document Processing panel reports in Obsidian notices and devlogs.

Tool calls & MCP approvals

Agent mode can require your approval before a tool touches your vault or runs an MCP action. When a provider suggests a plan, the approval modal collects everything into one review step.

  • The chat collects related tool runs into a single approval request so you can review once.
  • Approval modals explain the plan before anything touches your files or vault.
  • Model Context Protocol (MCP) tools you approve in settings appear as toggles inside the approval view.
Settings → Overview & SetupManage trusted MCP tools or auto-approve mode when advanced settings are enabled.
Command paletteUse Clean Up Phantom MCP Tools if a server disappears so the list stays accurate.

Slash commands

The composer recognises slash commands everywhere in chat. Use these shortcuts to speed up common actions.

CommandDescription
/newOpen a blank conversation in a new leaf.
/clearRemove all messages from the current thread.
/agentSwap to another system prompt or agent preset.
/exportLaunch the export modal with markdown options.
/historyJump to the markdown file backing the active chat.
/saveStore the conversation in your saved chats directory.
/deleteRemove the chat file and close the view.

History & exports

Chats persist as markdown files inside your saved chats folder. These helpers make it easy to reopen or share a transcript later.

  • Each conversation saves as a markdown file, including the model, system prompt, and attached context.
  • Opening a chat history note gives you a “Resume this chat” shortcut when stored metadata is present.
  • Exports offer clean markdown or JSON copies for sharing outside Obsidian.