Using Plugins

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

Caution

Only install plugins from trusted sources. A plugin can read and write to your vault and access Atlas 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 in the Marketplace

The Marketplace tab in the Plugins panel is where you find community-built plugins. You can search by name or description, filter by category, and sort by most downloaded, highest rated, or newest.

Plugin Categories

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

Note

Downloading plugins from the marketplace requires an active paid plan. Free tier users can browse and read plugin listings, but cannot install from the marketplace. You can still install plugins manually by placing them in the plugins directory.

Installing Plugins

Plugins can be installed from two places:

• From the Marketplace: Find the plugin you want, click Install, review its permissions, and confirm
• Manually: Place the plugin folder in the plugins directory and click Reload 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 Atlas agent tools programmatically
ui_components	Render custom UI panels inside Atlas
config	Read (but not write) Atlas 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.

Ratings and Reviews

If you’re on a paid plan, you can rate and review any plugin you’ve installed:

1. Open the plugin’s listing in the marketplace
2. Click Rate this plugin
3. Choose 1–5 stars and optionally write a short review
4. Submit

Ratings help other users discover quality plugins and give authors feedback.

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, malicious, or violates the marketplace guidelines, use the Report option on the plugin listing. The Atlas team reviews all reports.

---

To build your own plugin, see Building Plugins.