Documentation

Troubleshooting

Each fix mirrors the guardrails built into the plugin. Follow the steps below before escalating to support.

Rapid fixes

Managed Chat returns a license or connection error
Open Settings → SystemSculpt → Account, activate your license again, and retry the message.

Work through each step in order. Most issues clear up after validating the account or reprocessing a document.

Transcription stalls at Processing…
Keep Obsidian open while the managed job runs, then retry from the recorder or Janitor if the status does not advance.

Work through each step in order. Most issues clear up after validating the account or reprocessing a document.

Embeddings never finish indexing
Confirm your SystemSculpt license is active, check vault exclusions, and run the embeddings rebuild action again.

Work through each step in order. Most issues clear up after validating the account or reprocessing a document.

Context files are ignored in responses
Verify the file appears as a chip above the composer. Re-add via drag-and-drop and watch the processing panel for errors.

Work through each step in order. Most issues clear up after validating the account or reprocessing a document.

Instrumentation you can trust

These utilities run inside the plugin and expose the same state inspection hooks the team uses during QA.

Request ID
Copy the visible request ID from a failed managed operation when contacting support.
Credits & usage
Shows the managed account balance and recent metered operations.
Account status
Revalidates the SystemSculpt license and surfaces a bounded account or connection error when activation fails.
Embeddings status
Shows index progress and provides a managed rebuild action when vault search needs repair.

Retry from the failed attachment or job state, then capture its request ID if the operation still fails.

Collect logs before you escalate

Capture the exact action, visible notice, and affected job or chat before contacting support.

Open janitor
Opens the Janitor panel to review empty files and stored outputs before moving selected items to Obsidian Trash.

Call from: Command palette → Open janitor

Open AI settings
Jumps straight to the SystemSculpt Account settings tab.

Call from: Command palette → Open AI settings

Open credits & usage
Shows your current credit balance and recent managed usage.

Call from: Command palette → Open credits & usage

TipInclude your plugin version, exact reproduction steps, visible notice, and a screenshot when you email support@SystemSculpt.com or open a GitHub issue.

Still stuck?

Review the support playbook for escalation paths and response-time expectations, or browse the FAQ for policy questions.