Plugins

Plugins connect Agentty with other apps and add tools to your terminals. A plugin can put a panel next to your terminals, add buttons above agent panes, add entries to the command palette, and hand text to an agent as a prompt — always after you choose where it goes.

Writing one? Start with the plugin quick start.

The Plugins page#

Open it from the activity bar (the puzzle icon), View → Plugins, or the command palette (⇧⌘P → "Plugins").

• Installed — every plugin you have, with what it adds and what it may do.
• Available — plugins that ship with Agentty. If the app a plugin integrates with is installed, it is marked Recommended.
• Build your own — create a plugin with AI, or install one from a Git repository or a folder.

Each installed plugin has Enable / Disable, Open Panel, Restart (after editing its code), Update (when Agentty ships a newer built-in version), Logs (what the plugin printed, crashes included), Show in Finder, and Uninstall (press twice to confirm).

Plugins start when you first use them, not when Agentty launches, so an idle plugin costs nothing.

Installing#

You can also copy a plugin folder into ~/.agentty/plugins/ yourself and press Refresh.

Using a plugin#

• Panel — plugins with a panel get a button in the tab strip. Click it to open the panel next to your terminals, click again to close. The ↻ in the panel header restarts the plugin; the gear opens the Plugins page.
• Buttons above terminals — plugin commands can appear as icons in the status bar above a Claude Code or Codex pane, and in split-pane headers. They act on that pane.
• Command palette — ⇧⌘P lists every plugin command under Plugin.

The "Send to…" dialog#

When a plugin, or a link from another app, sends a prompt, Agentty shows what will be sent and lets you choose:

• Claude Code / Codex / Terminal
• New workspace (with a folder you can change), New tab in the current workspace, or one of your open workspaces — an idle agent there receives it, otherwise a new agent tab opens
• Send right away, or leave it unchecked to have the text typed in without pressing Enter

Terminals only ever get the text typed in; Agentty never runs it for you. Nothing is sent until you press Send.

Links from other apps#

Other apps can hand work to Agentty with agentty:// links — for example Cosmica's "Continue in Agentty".

If a link needs a built-in plugin you don't have yet, Agentty offers to install it and then continues with the link. Prompts that arrive this way always go through Send to….

Cosmica#

Cosmica is a notes app. Its plugin ships with Agentty and is marked Recommended when Cosmica is installed. It reads only the notes folder and local port from Cosmica's own settings.

1. Plugins → Install on the Cosmica card, then open its panel from the tab strip.
2. Notes → prompt — search your notes, then insert one into the focused terminal or continue it somewhere you choose.
3. From Cosmica — right-click a note → Continue in Agentty. The note is saved first, then Send to… opens in Agentty.
4. Session → Cosmica — with a Claude Code or Codex pane focused, Save AI summary asks the agent to write a structured summary (goal, what was done, files changed, decisions, next steps) into Agentty/ in your notes. Save conversation log stores the raw conversation without asking the AI anything.

Busy agents are left alone; try again when the turn finishes. While Cosmica is running, notes are saved through its local API so they are indexed right away; otherwise the file is written and Cosmica picks it up on its next start.

If something goes wrong#

Where things are#

Uninstalling removes the plugin; its data folder stays until you delete it.

Next#

• Plugin quick start — write one in a few minutes
• Manifest reference · Node.js SDK · Protocol
• Permissions · Publishing