PeriCode for Obsidian

An AI sidebar for your notes, research and vault management. Free and open source under MIT.

Ask questions about your vault, follow sources back to your notes, organize your files and review suggested revisions inside Obsidian. Connect your preferred AI provider and choose from the models available to your account.

Website · Download the plugin · User guide · Report an issue

0.3.5 preview · Desktop only · Requires Obsidian 1.13.7 or newer

What you can do

• Chat beside your notes. Use the sidebar or expand the chat workspace; save, resume and export conversations.
• Research with context. Attach notes, folders or selected passages and follow source links in responses.
• Manage your vault. Find and read notes; create, edit, organize and trash files through vault-scoped tools with permission checks.
• Review revisions. Preview suggested changes to a selection before accepting.
• Choose your provider. Use a supported subscription connection, API key, or local model server.
• Control access. Start in Research mode for inspection and navigation; use Agent mode for changes governed by your permission settings.

Install

PeriCode is available in Obsidian's community catalog. On September 11, 2026, version 0.3.5 opened from the public listing and passed a native Obsidian reinstallation, with settings preserved and vault operations verified afterward.

1. Open Settings → Community plugins → Browse in Obsidian.
2. Search for PeriCode, select it, then choose Install and Enable.
3. Open Settings → PeriCode → AI connection, connect your provider, load models and choose one. Open the PeriCode sidebar to start.

You can also open the community listing and select Add to Obsidian. Community plugins require Restricted mode to be off.

Manual installation

If the catalog is unavailable on your device, use the same signed release files:

1. Open the latest GitHub release.
2. Under Assets, download main.js, manifest.json and styles.css. Use these release assets, not the GitHub Source code ZIP.
3. Open your vault folder in your file manager. Show hidden files if needed, then create .obsidian/plugins/pericode/ inside it.
4. Put the three downloaded files directly in that folder, with no extra nested folder.
5. Reload or restart Obsidian. Open Settings → Community plugins and enable PeriCode. Community plugins require Restricted mode to be off.
6. Open Settings → PeriCode → AI connection, choose a provider, connect it, click Load models, and select a model. Open the PeriCode sidebar to start.

Installation is per vault. Repeat these steps for each vault where you want PeriCode. Requires Obsidian desktop 1.13.7 or newer.

Use PeriCode

1. Connect an account in Settings → PeriCode → AI connection. A completed connection shows Connected and Sign out after restarts.
2. Select Load models, choose a model, then open the PeriCode sidebar.
3. Review a starter draft and press Send. Use Research for read-only work and Agent for permission-checked vault, shell, Git, test, web and integration tools.
4. Select Scaffold this vault to create the standard knowledge layout while preserving existing files.
5. Delete the current chat through three-dot menu → Delete chat → Delete conversation.

Type / in an empty composer for provider-independent commands including /new, /compact, /models, /scaffold, /tools, /settings, and /help. /compact condenses older working context while preserving the visible transcript. Tool activity stays collapsed in the sidebar and opens automatically in expanded chat mode.

Settings, credentials and conversations are stored separately in each vault.

On Windows, the release ZIP also includes Install-PeriCode.cmd for guided installation. Installation is per vault. See the installation guide for installer options and registered-vault support.

AI connections

Subscription connections include Claude, ChatGPT / Codex, GitHub Copilot, Grok and Ollama Cloud, subject to provider eligibility and usage limits. Some use the provider's separately installed sign-in runtime. API connections include Anthropic, OpenAI, Grok and OpenRouter; local/custom endpoints are also supported.

Choose a connection and use Load models in settings. Account access is checked by the provider; one provider's subscription does not transfer to another. PeriCode has no paid tiers, trials or activation keys. Provider subscriptions and API usage may have their own charges.

See provider setup for requirements and known validation limits. Automated tests do not establish that every live account connection works. Grok 4.5 and 4.6 passed chat and guarded vault reads; broader Grok workflows and Ollama Cloud still need verification.

Privacy and permissions

Prompts, attached notes and tool results go to the model endpoint you configure. API keys, conversations and plugin state are currently stored unencrypted. Provider sign-in runtimes and optional MCP servers have their own data access and trust boundaries. Read the data and access disclosures before connecting sensitive vaults.

Permission checks remain required. Research mode limits tool use; Agent mode allows changes under the configured policy. See security guidance and the plugin security notes.

Source and contributions

The plugin source is in plugins/obsidian. Its shared agent runtime and provider adapters are in src. Installable plugin files are published in the release repository.

See CONTRIBUTING.md for build and test instructions, QA.md for recorded evidence, and the submission checklist for directory readiness. Community listing published September 11, 2026. See the plugin QA.md for review limits.

License

Copyright 2026 Eddy Ogutu. MIT licensed, with all plugin features included. Bundled dependencies retain their own licenses and notices.