We're currently undergoing massive updates and changes to the core infrastructure of SystemSculpt. Website and plugin updates are occurring daily.

Chat And Interface

3 min read

Welcome to SystemSculpt AI, your intelligent assistant integrated directly into Obsidian. This guide covers everything you need to know about using the chat interface and navigating the plugin.

Quick Start

  1. Open SystemSculpt: Click the brain icon in your left sidebar or use Command Palette: "SystemSculpt: Open Chat"
  2. Start chatting: Type your message and press Enter
  3. Add context: Use the @ symbol to reference files or drag and drop content

Chat Features

Basic Chat Operations

  • Send Message: Type and press Enter
  • New Chat: Click the + button in the chat interface
  • Stop Generation: Press Escape or click Stop while AI is responding
  • Clear Chat: Use the /clear command or Command Palette

Message Management

  • Edit Messages: Click any of your messages to modify them
  • Regenerate: Click the regenerate icon to get a new response
  • Copy: Click the copy icon to copy AI responses
  • Delete: Remove individual messages from the conversation

Advanced Features

  • Voice Input: Click the microphone icon or use "SystemSculpt: Toggle Audio Recorder" command (Default: Ctrl/Cmd + R)
  • Multiple Chats: Manage multiple conversations in parallel
  • Export: Use /export command to save conversations as markdown files
  • Save Chat: Use /save command to save current chat

Interface Overview

Main Components

  1. Chat Panel

    • Message history with your conversations
    • Input area with formatting toolbar
    • Model selector in the header
  2. Sidebar

    • Chat list showing all conversations
    • Search to find past chats
    • Folders for organization
  3. Header Controls

    • Model selection dropdown
    • Settings gear icon
    • Collapse/expand buttons

Keyboard Shortcuts

SystemSculpt commands that can have hotkeys assigned in Obsidian settings:

  • Toggle Audio Recorder: Default Ctrl/Cmd + R
  • Open SystemSculpt Chat: No default hotkey
  • Open SystemSculpt Chat History: No default hotkey
  • Change Chat Model: No default hotkey
  • Escape: Stop generation (built-in)

Essential Settings

SystemSculpt has 12 settings tabs:

Setup & Connect

  • License Key: Enter your SystemSculpt license
  • API Provider Configuration: Add your API keys for various providers

AI Chat Settings

  • Default System Prompt Type: General Use, Concise, or Custom
  • Default Chat Font Size: Small, Medium, or Large
  • Auto-Enable Vault Structure: Include vault structure in new chats
  • Favorite Models: Manage your favorite AI models

Directories

  • Chats Directory: Default "SystemSculpt/Chats"
  • Saved Chats Directory: Default "SystemSculpt/Saved Chats"
  • Recordings Directory: Default "SystemSculpt/Recordings"
  • Attachments Directory: Default "SystemSculpt/Attachments"
  • System Prompts Directory: Default "SystemSculpt/System Prompts"

Tips for Best Experience

  1. Use @ References: Type @ to quickly add file context
  2. Markdown Formatting: AI responses support full markdown
  3. Code Blocks: Responses include syntax highlighting
  4. Responsive Design: Works on mobile and desktop
  5. Theme Support: Fully compatible with Obsidian themes

Common Issues

Chat not opening?

  • Check keyboard shortcut conflicts in Obsidian settings
  • Ensure the plugin is enabled

Responses cut off?

  • The plugin uses model defaults for response length
  • Consider using a different model if responses are too short

Usage tracking?

  • Check your API provider for usage limits
  • SystemSculpt Pro users see credit balance in the interface

Next Steps