Files
paseo/plugin-examples/linear
Mohamed BoudraandGitHub 6d7606160e Let plugins add contextual workspace tools (#3465)
* feat(plugins): add workspace panels and command center contributions

Give local plugins contextual UI entry points without making the daemon interpret client placement or callbacks. Panels receive stable IDs and read cached client state through required selectors with shallow equality, avoiding unrelated guest rerenders and context-discovery RPCs.

* fix(plugins): align shared client state ownership

Workspace panels and Command Center callbacks consume the same frozen client snapshots, so their adapter belongs to the plugin boundary rather than either contribution surface. Refresh the Nix dependency hash for the selector-store dependency added by this feature.
2026-08-17 19:26:40 +02:00
..

Linear plugin example

This example adds Attach Linear issue to the composer. Search by issue identifier or title, then send a stable issue snapshot to the agent.

Set a personal API key in the daemon environment:

export LINEAR_API_KEY="lin_api_..."

Register the extension in $PASEO_HOME/config.json:

{
  "pluginsEnabled": true,
  "plugins": {
    "linear": {
      "source": "directory",
      "path": "/absolute/path/to/paseo/plugin-examples/linear"
    }
  }
}

Restart the development daemon after changing its environment or plugin configuration.

The entry point demonstrates the complete attachment-source pattern:

  • define one validated search RPC;
  • handle it in the daemon subprocess;
  • register a declarative attachment source for the client;
  • keep credentials and vendor API calls out of the client bundle.