{"id":"paseo-clusters","repo":"thisjrodriguez/paseo-plugin-clusters","url":"https://github.com/thisjrodriguez/paseo-plugin-clusters","package":"@thisjrodriguez/paseo-plugin-clusters","npm":{"package":"@thisjrodriguez/paseo-plugin-clusters","version":"0.1.1","integrity":"sha512-FMy49JzJcHtHzABXcng7O+H2s+YZmf5/VqlDaDVCU1isMtvhEEEo2Dq81wvRnsLEAbOlyhfdAG317oBp9ngRNg==","publishedAt":"2026-09-21T08:41:12.772Z","downloadsLast30Days":0},"name":"paseo-clusters","description":"Clusters de proyectos para la barra lateral de Paseo","categories":["productivity"],"platforms":[],"caveats":["The sidebar circles only appear in the desktop app; iOS and Android get the Clusters screen instead.","It hooks into Paseo's sidebar through its data-testid attributes, so a Paseo UI update may break it.","Clusters are stored per daemon and shared by every client connected to that daemon."],"images":["https://raw.githubusercontent.com/thisjrodriguez/paseo-plugin-clusters/5fe512c4cfa01aa0c4d7a4441847e5eff0e0c610/images/sidebar.png"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":false,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-21T09:31:32.229Z","addedAt":"2026-09-21T09:29:37Z","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-21T09:31:18.372Z","version":"0.1.1","integrity":"sha512-FMy49JzJcHtHzABXcng7O+H2s+YZmf5/VqlDaDVCU1isMtvhEEEo2Dq81wvRnsLEAbOlyhfdAG317oBp9ngRNg=="},"version":"0.1.1","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-21T09:31:18.372Z","commit":"5fe512c4cfa01aa0c4d7a4441847e5eff0e0c610"},"license":"MIT","paseoVersionRequirement":">=0.8.0","descriptionNodes":[{"type":"text","text":"Clusters de proyectos para la barra lateral de Paseo"}],"caveatNodes":[[{"type":"text","text":"The sidebar circles only appear in the desktop app; iOS and Android get the Clusters screen instead."}],[{"type":"text","text":"It hooks into Paseo's sidebar through its data-testid attributes, so a Paseo UI update may break it."}],[{"type":"text","text":"Clusters are stored per daemon and shared by every client connected to that daemon."}]],"manifest":{"id":"paseo-clusters","requirements":{"paseo":">=0.8.0"},"build":[["npm","ci","--omit=dev"]]},"repoMeta":{"stars":2,"defaultBranch":"main","pushedAt":"2026-09-21T08:51:28Z"},"owner":{"login":"thisjrodriguez","avatarUrl":"https://avatars.githubusercontent.com/u/5730714?v=4"},"installNotesHtml":"<pre><code class=\"language-bash\">paseo plugin install github:thisjrodriguez/paseo-plugin-clusters\n</code></pre>\n<p></p>","limitationsNotesHtml":"<ul>\n<li>Paseo <strong>0.8.0</strong> or newer.</li>\n<li><strong>Desktop only.</strong> The circles are injected into the app's web UI, so they do not appear on iOS or\nAndroid. On mobile the Clusters screen still lists your clusters and their workspaces.</li>\n<li>The plugin relies on the <code>data-testid</code> attributes of Paseo's sidebar. They are stable, but a Paseo\nupdate may change them; open an issue if something stops showing up.</li>\n</ul>","readmeText":"# paseo-plugin-clusters\n\n*English · [Español](README.es.md)*\n\nA [Paseo](https://paseo.sh) plugin that groups your projects into **clusters** and puts them as\ncircles above the workspace list, Discord-style.\n\n## Installation\n\n```bash\npaseo plugin install github:thisjrodriguez/paseo-plugin-clusters\n```\n\n![Cluster circles above the Paseo workspace list](images/sidebar.png)\n\n## What it does\n\n- **Circles in the sidebar.** A row above \"New workspace\". Selecting a cluster filters the native\n  list down to its projects.\n- **Recents.** Projects used in the last 24 hours. A project enters at the top once, then keeps its\n  place until you drag it elsewhere, and drops out after 24 idle hours.\n- **All.** The full list, exactly as Paseo shows it.\n- **Status rings.** Dashed while a workspace in the cluster is running, green when one has finished\n  and you have not opened it yet.\n- **Drag and drop.** Drag a project onto a circle to move it into that cluster, or up and down to\n  order it inside the cluster. The circles reorder by dragging too.\n- **Management screen.** Create clusters with a name, an icon (letter, emoji or symbol) and any hex\n  color; move projects between clusters; search; and an All tab listing unassigned projects.\n- **One project, one cluster.** New projects join whichever cluster is selected.\n- **Synced.** Clusters live on the daemon, so every client connected to that machine shares them.\n  The selected circle stays per client.\n- **English and Spanish**, following the client's language, with a picker in the cluster form.\n\n## Limitations\n\n- Paseo **0.8.0** or newer.\n- **Desktop only.** The circles are injected into the app's web UI, so they do not appear on iOS or\n  Android. On mobile the Clusters screen still lists your clusters and their workspaces.\n- The plugin relies on the `data-testid` attributes of Paseo's sidebar. They are stable, but a Paseo\n  update may change them; open an issue if something stops showing up.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\npaseo plugin install /path/to/paseo-plugin-clusters\npaseo plugin reload paseo-clusters   # after every change\npaseo plugin logs paseo-clusters\n```\n\n| File | Purpose |\n| --- | --- |\n| `index.client.tsx` | Registers the screen and menu, starts the bar and the sync |\n| `client/web.ts` | Circle bar, native list filtering, drag handling and state |\n| `client/clusters.tsx` | Cluster management screen |\n| `client/cluster-form.tsx` | Create and edit form |\n| `index.server.ts`, `server/storage.ts` | Stores clusters on the daemon |\n| `shared/i18n.ts` | English and Spanish strings |\n\n## License\n\nMIT\n"}