Documentation

Getting started

Prepare Obsidian, validate your SystemSculpt account, and confirm the chat workspace is ready for production use.

Prerequisites

Make sure these basics are in place before you enable the ribbon actions. They match the checks the plugin runs the first time it loads.

  • Obsidian 1.7.2 or later with community plugins enabled.
  • A SystemSculpt license key for SystemSculpt AI.
  • Writable directories for chats, recordings, and extractions (configured under Settings → SystemSculpt → Workspace).

Install & enable

Start with the official Obsidian community plugin listing, open the settings tab, and activate your license. Chat and the other SystemSculpt capabilities are ready as soon as activation succeeds.

  1. 1

    Install from the official Obsidian community listing

    Open the official Obsidian community plugin listing for SystemSculpt AI, install it into your vault, and enable “SystemSculpt AI” under Settings → Community plugins. Use a manual .obsidian/plugins folder copy only when you are testing a local build or recovering from an Obsidian listing issue.

  2. 2

    Activate your license

    Open Settings → SystemSculpt → Account, paste your SystemSculpt license key, then click “Activate”. The service address is built into the official plugin.

  3. 3

    Confirm SystemSculpt AI is ready

    After activation, Chat, embeddings, transcription, document processing, and image generation are ready through the SystemSculpt service.

  4. 4

    Review storage directories and open the chat view

    Confirm chat, recordings, extractions, and saved notes directories, then launch the SystemSculpt chat ribbon icon to start a conversation.

First-use checklist

Walk through these steps once you are connected. If anything fails, Obsidian will show a notice or log entry so you know exactly what to adjust.

  • Open SystemSculpt Chat from the left ribbon and confirm the managed chat identity is ready.
  • Attach a markdown note or supported file and verify its chip appears above the composer.
  • Send a prompt to watch streaming responses and, if enabled, approve any tool calls.
  • Open Chat history and confirm the conversation appears in your configured chats folder.

Key settings surfaces

Account tab
Activate your license, confirm SystemSculpt AI status, and run quick diagnostics when connection issues appear.
Workspace tab
Control where chats, saved chats, recordings, attachments, and extractions are stored so every workflow writes to a known folder.

Need help choosing between monthly billing and the lifetime license before activation? Review Billing & licenses for cancellation and policy details.