SystemSculpt
Install free (opens Obsidian's plugin directory in a new tab)
Documentation

Get started with SystemSculpt

Updated for SystemSculpt 6.18 ·

Install SystemSculpt from Obsidian's community plugins, then choose how to run your chat. Installation is free. Your own Claude Code or Codex needs no SystemSculpt account or plan; hosted SystemSculpt AI uses a SystemSculpt account and credits.

On this page

Install the plugin

  1. Open Obsidian Settings → Community plugins.
  2. Find SystemSculpt AI, select Install, then Enable.
  3. Run Open chat from Obsidian's command palette.

For an agent-assisted filesystem install, the plugin ID is systemsculpt-ai. Download manifest.json, main.js and styles.css from one tagged official release (opens in a new tab) into a new empty staging directory. Check the manifest ID, version and minAppVersion, then copy the three files into <vault>/.obsidian/plugins/systemsculpt-ai/, or the equivalent custom Obsidian configuration folder. Preserve existing settings and installations. Files on disk do not prove enablement: open this vault in Obsidian, go to Settings → Community plugins, exit Restricted mode (Turn on community plugins) and enable the plugin. If Obsidian already had this vault open, that page shows 0 plugins installed until you press Reload plugins there; the install and the vault are fine, so do not reinstall. SystemSculpt is not an npm package or a Claude Code plugin.

Use your own Claude Code or Codex on desktop

  1. Install the CLI you want to use and sign in on this computer. For Codex, use codex login. For Claude Code, run claude and use /login if sign-in is needed.
  2. In SystemSculpt chat, choose Claude Code or Codex in the run line below the message box.
  3. If you installed or signed in after opening the plugin, use Detect again in the backend menu.

SystemSculpt can choose a ready native backend automatically, while preserving your explicit choice and an existing paid hosted selection. Check the run line instead of assuming which backend will answer. See Choose your AI and the Claude Code guide.

SystemSculpt chat's backend menu listing Claude Code and Codex on this Mac and hosted SystemSculpt.SystemSculpt chat's backend menu listing Claude Code and Codex on this Mac and hosted SystemSculpt.
The line under the message box shows who answers. Choose Claude Code, Codex or SystemSculpt in one click.

Use hosted AI, including on mobile

  1. Open Settings → SystemSculpt AI → Account.
  2. Select Sign in or Sign up and complete the browser flow. If you already have a license key, License key → Activate is also available.
  3. Return to Obsidian and check the account connection. If the browser cannot return automatically, choose Open the sign-in page again, paste the Connection code, then choose Complete sign-in.

Start sign-in from the plugin in this vault, not a bare /plugin/connect URL: the plugin creates a pending connection and its verifier. A connection code completes that pending connection, not an unrelated browser login. If your tools cannot finish a browser or Obsidian step, report it as pending. Do not store connection codes or license keys in chat or setup notes.

Eligible new accounts can claim 500 one-time starter credits with no card required. Follow any email-verification instructions shown during sign-in. After sign-in, the result offers Summarize my latest note, which runs on those credits and opens the answer in a new chat; a vault with no notes gets Start a chat instead. On Obsidian mobile, chat uses hosted SystemSculpt AI rather than a desktop CLI.

Send a first message

Choose the backend and review the mode below the message box. New chats start in Auto, with the backend's own approval behavior. Type @ to select a note, then ask: “Summarize the decisions in this note.” On desktop, Enter sends; on touch devices, use Send. If an action needs approval, read its inline request before deciding.

To check hosted AI specifically, choose SystemSculpt in the run line, check the connected account and available credits, and send: “Create a note named SystemSculpt setup check.md containing: Hosted setup check completed.” Follow any approval request the selected mode shows, then open that file and check its contents. A Claude Code or Codex reply, or a file written directly by your setup agent, does not verify hosted SystemSculpt. If connection, entitlement or credits block the request, record the blocker rather than claiming it worked.

Your separate chat transcript defaults to SystemSculpt/Chats/<chat-id>.md; a chat title is not necessarily its filename. Check Settings → SystemSculpt AI → Workspace if you changed the chats directory. Learn attachments, history and approvals. Semantic indexing is optional; it is not required to finish installation.

Still need help? Contact SystemSculpt.