Plugins

DataMind Oda is put together from plugins, and a bundle groups plugins into one package. The Plugins page is where you manage them: switch a plugin or a bundle on or off, see what a pack contains, install more from a package name, a repository address or a folder on this computer, and open the settings a plugin brings. The page is part of Oda's developer surface, so it stays hidden until its feature switch is on.

Open the Plugins page

1. Open Settings > Developer > Advanced features and turn on the Plugins page feature; Advanced features covers that list.
2. Open Plugins in the sidebar.

The sidebar entry and the page exist only while that feature is on. Memory, skills and connectors shows where the switch sits among Oda's settings.

While the page reads, it shows Reading plugins…. If it cannot read everything, it says Could not read all plugins, possibly due to a network problem and offers Retry. When this installation runs without a manageable profile, it reads This deployment runs without a manageable profile, so plugins cannot be installed or switched here., and both installing and switching stay unavailable. An installation with nothing to show reads No plugins are installed yet.

What the page lists

• The Official group holds the feature bundles this installation ships switched off, and the built-in plugins that have settings of their own; the Installed group holds the bundles added on this computer. Each group shows a count of its cards.
• Cards are ordered by name, so switching one does not move it.
• A card shows the name, description and icon its package declares. Reading the page shows these without starting anything: a plugin loads only once it is switched on.
• A Beta tag marks a beta package. A row that could not be read carries a Problem tag with its reason and cannot be switched on until the problem is fixed.
• A row's state reads Waiting for dependencies, Loading, Running, Unloading, Problem or Not running. The switch beside it shows your saved choice, not a report that the plugin loaded, so a broken bundle keeps its row, its reason and its saved choice.
• The rows that manage plugins themselves stay locked and are never removable: Plugin management needs it; it cannot be switched off or uninstalled.
• A second, read-only list sits under Settings > Built-in plugins: it inspects what this installation loads and changes nothing. Built-in plugins covers it.

Switch a plugin or a bundle on or off

1. Find the row and flip its switch.
2. Watch the row: it moves through Waiting for dependencies and Loading to Running, or reports Problem.

• Switching a bundle moves the parts it groups together; a part's own switch changes only that part.
• The change applies to every chat in this installation. Where live apply is on, it takes effect while Oda runs; otherwise the row reports The change takes effect at the next start. How changes apply and what start-up reports covers the timing.
• When a higher-priority configuration wins, the notice reads {name} was saved, but a higher-priority configuration overrides it, so it is not in effect.
• A failed switch reports Could not enable: {reason}, Could not disable: {reason}, or, for a part, Could not enable the component: {reason}.
• Switching a plugin off waits for what it was doing, then unloads its code and styles; switching it back on loads a fresh copy.

Look inside a pack

Open a card to see the plugin's own page; the crumb reads Plugins, Back to plugins returns to the list, and Back to {name} appears when you came from another plugin's page.

• The Components section lists the parts a pack contains, each with its own state and its own switch. The switch reads Enable component followed by the part's name, and it changes only that part.
• A summary counts the parts by state, for example 3 total · 3 off.
• Filter components narrows the list; with nothing matching it reads No component matches., and a pack that brings no parts reads This plugin pack contains no components.
• Once a list on the page holds more than ten rows, a filter box appears above it.

Open a plugin's settings

Some plugins and bundles bring settings you edit from their page.

1. Open the plugin and open its settings.
2. Edit the fields you need.
3. Choose Save.

• An edit stages until you save; leaving the page drops what you have not saved.
• A field holding your value is marked Overridden, and Reset to default clears it.
• What the Official group holds depends on what this installation ships. Where a plugin is present, opening it shows its card: Subagent sets the delegation limits and which models subagents may use (Subagent settings), and Agent loop bounds parallel tool calls (Agent loop settings). Agent Teams and Voice input are marked Beta, and voice input may install extra components the first time you use it (Agent Teams, Set up voice input).
• Some plugins also take live edits while Oda runs; Live plugin settings covers those forms.

Install a plugin

1. On the Plugins page, choose Add plugin.
2. In Package name or address, enter the plugin's package name (it can carry a version), a GitHub repository address, or the path to a local plugin folder on this computer. The field shows the example for example @acme/datamind-plugin.
3. For the exact forms, expand Install guide and examples: Package name, GitHub repository address and Local plugin directory, each with an example and a Use example button. Pressing Enter in the field starts the check too.
4. Open Registry if you want a different download source; the next section covers the choices.
5. Choose Install. Oda reads the address first, with Checking…, then starts the run.

The dialog carries the warning Install only plugins you trust: they run with your permissions and can damage DataMind Oda or leak your data.

Before anything downloads, the check refuses an address it cannot accept. The sentence shows under the field, the address stays editable, and nothing is installed:

• This is not a package name or address that can be installed: {reason}
• This plugin is already installed
• No such plugin was found
• The path does not exist or is not a valid plugin package
• This package declares no bundle, so it cannot be installed as a plugin: {reason}
• The plugin registry could not be reached; check the network and try again
• No registry could be reached (tried: {registries}); check the network or proxy settings, or change the registry

Choose the download source

• Registry names the source the install asks first: Default registry, the mirrors this installation offers, and Custom address.
• A Custom address must start with http:// or https://; anything else is refused with Enter an address starting with http:// or https://. A hint explains that private sources belong here, and where a source's login credentials go.
• Your last choice starts the next dialog.
• When the first source cannot serve the package, the run says so and asks the next one: {previous} could not serve the package; retrying through {registry} (registry {index} of {total}).

While an install runs

• The installing screen shows the package as Oda read it: its name, one-line description and version.
• Show install details folds the run's log: Running, Failed or Done, an exit line such as exit code {code}, and Copy, Copied and Collapse controls. A long log folds after 12 lines, keeping the start and the end.
• One install runs at a time, and while a run is tracked the page's main button reads View installation.
• Cancel install stops a run while it still can: a cancellation during the download waits for confirmation, and once Oda starts applying the change the run cannot be cancelled.
• Closing the dialog hides it. Oda asks to cancel when that is still possible; a run past that point finishes on its own and reports through a notice, and View installation reopens a tracked run.
• A cancelled install switches nothing on: Installation cancelled; the plugin is not enabled, and downloaded files may remain.
• When Oda cannot tell how a run ended, the screen reads Installation status unconfirmed and offers Check installation status.

When packages want to run install scripts

Some dependencies want to run their own install scripts. Oda does not run them on its own; the failed screen lists the packages and explains:

• These packages have install scripts that pnpm did not run.
• Once allowed, the scripts run here with your permissions, and the permission is saved in this profile.
• Allow only packages you trust.

In place of Retry, the screen offers Allow these scripts and retry, which allows the scripts still waiting and retries the install. The permission is saved for those packages, so a later install does not ask again, and the finished screen reads Install scripts allowed for {names}.

When an install finishes

• The done screen reads Install finished with no new dependency. or Installed; it loads at the next start.
• Enable now switches the new plugin on, closes the dialog and scrolls its card into view; Done closes the dialog and leaves it installed and off.
• A successful install does not promise the plugin can start: if it fails to load, its row reports the problem, and the plugin cannot be switched on until it is repaired.

When an install fails

The failed screen shows one line, and Show install details holds the full output. Retry runs the install again; Change registry appears when the source was the problem and no scripts are waiting for permission, and choosing it returns you to the address with the source options open.

• The network connection failed
• No registry could be reached (tried: {registries}). Check the network or proxy settings, or change the registry and retry.
• {host} could not be reached. A GitHub address or a .tgz link is not fetched through the registry: this machine must reach it directly or through a proxy. If the plugin is also published to npm, enter its package name instead.
• No version matches the request
• The disk is full; the install stopped
• No write permission; the plugin cannot be installed
• The downloaded package failed its integrity check
• The install timed out
• Something went wrong during the install; the details say what

A failed or cancelled install puts the package records back, so the app is as it was; files already downloaded can stay.

Remove an installed plugin

1. Open the plugin's page and choose Uninstall.
2. Confirm in the dialog, which asks Uninstall "{name}"? and explains What it provides goes away once it is uninstalled.

Oda unloads the plugin before the package is removed.

• Oda refuses to remove what it manages itself, and it refuses a bundle whose parts another configuration still uses: Other configuration still uses this bundle's components; switch them off first.
• A refused removal changes nothing; the failure reads Could not uninstall: {reason}.

When Oda manages plugins for you

You can ask Oda in a chat to install, switch or remove a plugin. Every one of these actions needs Full access or your approval for that single action; approving does not change the chat's access mode, and a declined, cancelled or unavailable approval changes nothing. Installing runs plugin code with your permissions, so allow only what you trust. Oda performs the install itself, with nothing for you to run by hand. Plugins and bundles covers that chat side, and When Oda needs more access covers approvals.

Questions, answered

Why do I not see Plugins in the sidebar?

The page is part of Oda's developer surface, so it stays hidden until the Plugins page feature is on in Settings > Developer > Advanced features. Advanced features covers the switch and its risks.

How is a bundle different from a plugin?

A plugin is one of the parts Oda is built from; a bundle is a package that groups parts together under one switch. A bundle's page lists its Components, and switching the bundle moves those parts together, while a part's own Enable component switch changes only that part.

What do the states and tags on a row mean?

A row's state is one of Waiting for dependencies, Loading, Running, Unloading, Problem or Not running. A Beta tag marks a beta package, and a Problem tag comes with the reason the row could not be read; a row in that state cannot be switched on until it is repaired.

What does the switch record?

Your saved choice, not whether the plugin loaded. That is why a broken bundle keeps its saved choice on the switch while its row shows the problem. The choice belongs to this installation and applies to every chat; where live apply is off, it takes effect at the next start.

How do I see what a plugin pack contains?

Open its card: the Components section lists the parts, with a count for the states (3 total · 3 off), and each part's own state and switch. Filter components narrows the list; a pack that brings no parts reads This plugin pack contains no components.

Can I change a plugin's settings here?

Yes, for plugins that bring settings. Open the plugin and open its settings: edits stage until you choose Save, a field holding your value is marked Overridden with Reset to default, and leaving the page drops unsaved edits. Live plugin settings covers the forms some plugins expose while Oda runs.

Which source is a plugin downloaded from?

The one chosen in Registry: Default registry, a mirror this installation offers, or a Custom address. Your last choice starts the next dialog, and a custom address must start with http:// or https://.

Why does an install ask me to allow install scripts?

A dependency of the package wants to run its own install scripts, and Oda does not run them on its own. The screen lists the packages, Allow these scripts and retry allows the scripts still waiting and retries, and the permission is saved for later installs. Allowed scripts run with your permissions, so allow only packages you trust.

What happens when an install finishes?

The done screen reads Install finished with no new dependency. or Installed; it loads at the next start. Then choose Enable now to switch the plugin on and scroll to its card, or Done to leave it installed and off.

How do I remove a plugin I added?

Open its page and choose Uninstall, then confirm in the dialog. Oda unloads the plugin before the package is removed, and it refuses to remove what it manages itself or a bundle whose parts another configuration still uses.

Do plugins I install stay after I close Oda?

Yes. A plugin you install stays part of this installation, switched off until you switch it on, and it is removed only when you uninstall it. Your switch choices are saved with it.

Can Oda manage plugins for me in a chat?

Yes. You can ask Oda to install, switch or remove a plugin, and every such action needs Full access or your approval for that single action. Installing runs plugin code with your permissions, so allow only what you trust. When Oda needs more access covers approvals.