Using Plugins

Plugins let you extend NoteTalker beyond its built-in features. They’re small web applications that run locally on your machine and connect to NoteTalker through a local HTTP server.

Caution

Only install plugins from trusted sources. A plugin can read and write to your vault and access NoteTalker tools depending on the permissions it requests. Treat plugins like browser extensions — review what permissions they ask for before enabling them.

Enabling the Plugin Server

Before you can use plugins, you need to enable the plugin server:

1. Go to Settings > Plugins
2. Toggle Plugin Server on
3. The server starts on port 21847 by default (you can change this in settings)

The plugin server is a local-only HTTP server that runs on your machine. It’s not accessible from the internet.

Finding Plugins

Browse the community plugin directory at talkwithyournotes.com/plugins. You can search by name or description and filter by category. Each listing links to the plugin’s GitHub repository, where you download it before installing it in NoteTalker.

Plugin Categories

Category	What’s In It
Productivity	Task management, workflows, writing tools
Integration	Connect NoteTalker to external apps and services
Theme	Visual customizations and UI changes
Tool	New agent tools and capabilities

Note

There’s no in-app plugin store. You browse the directory on the web, download a plugin, and install it in NoteTalker from a URL or ZIP — every plugin installs the same way, at no extra charge.

Installing Plugins

Install a plugin from Settings > Plugins:

1. Find the plugin you want in the directory and open its GitHub repository
2. Download the plugin (usually a .zip file), or copy its repository URL
3. In NoteTalker, go to Settings > Plugins and click Install from URL/ZIP
4. Select the downloaded ZIP or paste the URL, review the permissions it requests, and confirm

You can also install a plugin by hand: drop its folder into {vault}/atlas/plugins/ and click Reload Plugins in Settings > Plugins.

After installing, the plugin appears in your Settings > Plugins list. Enable it there to start using it.

Managing Installed Plugins

Your installed plugins appear in the Plugins list in Settings > Plugins. From here you can:

• Enable or disable individual plugins with a toggle
• View plugin details: version, author, description, and permissions
• Regenerate the plugin secret if a plugin’s credentials are compromised

Disabling a plugin stops it from running but keeps it installed. You can re-enable it at any time.

Plugin Permissions

Each plugin declares what it needs access to. When you install or enable a plugin, you’ll see which permissions it’s requesting:

Permission	What It Allows
read_vault	Read files and notes from your vault
write_vault	Create, edit, and delete files in your vault
network	Make outbound network requests
execute_tools	Call NoteTalker agent tools programmatically
ui_components	Render custom UI panels inside NoteTalker
config	Read (but not write) NoteTalker configuration

A plugin that only needs read_vault and ui_components is lower risk than one requesting write_vault and network. Review permissions with that in mind.

If a Plugin Causes Problems

If a plugin is behaving unexpectedly:

1. Disable it in Settings > Plugins
2. Check the plugin’s documentation or repository for known issues
3. If you think it’s corrupting vault files, check the file diff preview (enable in Settings > Privacy)

If you find a plugin that’s broken or malicious, let us know through the feedback and contact channels so we can flag it in the directory. The NoteTalker team reviews every report.

---

To build your own plugin, see Building Plugins.