{"id":"tell-agent","repo":"omercnet/paseo-plugins","url":"https://github.com/omercnet/paseo-plugins/tree/main/tell-agent","package":"@omercnet/paseo-tell-agent","npm":{"package":"@omercnet/paseo-tell-agent","version":"1.2.2","integrity":"sha512-TO0cAxQmetcTG3LgGUwtkgxnPg8bw45W2vwlLrwh2LefNpksUQwF3cOT29s1a+YjRLMqJ9dt/Z216ebrG37Ilw==","publishedAt":"2026-10-20T12:48:34.475Z","downloadsLast30Days":6687},"name":"tell-agent","description":"Send messages to agents in other workspaces on the same Paseo host.","categories":["productivity","orchestration"],"platforms":[],"caveats":["Requires Paseo 0.8.x"],"images":["https://raw.githubusercontent.com/omercnet/paseo-plugins/main/tell-agent/docs/images/tell-agent-picker.png","https://raw.githubusercontent.com/omercnet/paseo-plugins/main/tell-agent/docs/images/tell-agent-compose.png"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-10-23T13:12:01.324Z","addedAt":"2026-09-10T20:00:21+03:00","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-20T14:48:06.627Z","version":"1.2.2","integrity":"sha512-TO0cAxQmetcTG3LgGUwtkgxnPg8bw45W2vwlLrwh2LefNpksUQwF3cOT29s1a+YjRLMqJ9dt/Z216ebrG37Ilw=="},"path":"tell-agent","version":"1.2.2","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-20T14:48:06.627Z","commit":"f17eeeaa3b10f8b6cd27891d8e8c7c8ea67061d6"},"npmPreview":{"package":"@omercnet/paseo-tell-agent","version":"1.2.2-next.279.1","integrity":"sha512-MmH0Jk/yTbWyc04Xe05FY6RrKoKVKCopwxbXiW7pka1BnAD69meDGsYuaHFVCnBG+CdHYw5Vt2p2SaONDuT2dQ==","publishedAt":"2026-10-20T12:50:38.079Z","distTag":"next"},"npmPreviewSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-10-20T14:48:06.627Z","version":"1.2.2-next.279.1","integrity":"sha512-MmH0Jk/yTbWyc04Xe05FY6RrKoKVKCopwxbXiW7pka1BnAD69meDGsYuaHFVCnBG+CdHYw5Vt2p2SaONDuT2dQ=="},"author":"Omer Cohen","license":"MIT","paseoVersionRequirement":"^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0","descriptionNodes":[{"type":"text","text":"Send messages to agents in other workspaces on the same Paseo host."}],"caveatNodes":[[{"type":"text","text":"Requires Paseo 0.8.x"}]],"manifest":{"id":"tell-agent","description":"Send messages to agents in other workspaces on the same Paseo host.","requirements":{"paseo":"^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0"}},"repoMeta":{"stars":24,"defaultBranch":"main","pushedAt":"2026-10-23T13:10:15Z"},"owner":{"login":"omercnet","avatarUrl":"https://avatars.githubusercontent.com/u/639682?v=4"},"installNotesHtml":"<h3>Paseo 0.9.0 or 0.10.1</h3>\n<p>Install the npm package:</p>\n<pre><code class=\"language-bash\">paseo plugin install npm:@omercnet/paseo-tell-agent\n</code></pre>\n<p>Update an npm installation by its plugin ID:</p>\n<pre><code class=\"language-bash\">paseo plugin update tell-agent\n</code></pre>\n<p>Paseo 0.9 and 0.10 use the reviewed update flow to show the current and proposed revisions before asking for approval. Add <code>--check</code> to preview without applying or <code>--yes</code> to skip the approval prompt.</p>","readmeText":"# tell-agent\n\nSend a message from one Paseo agent to another agent or workspace on the same daemon host.\n\n## Demo\n\nhttps://github.com/user-attachments/assets/93e67f62-67c5-4367-87ce-39da0aba7ebb\n\n## Screenshots\n\nAgent and workspace names are synthetic. Both PNGs were captured from an isolated Paseo test\ndaemon at 2× pixel density after browser DevTools verified that no private organization names\nremained in the rendered page.\n\n### Choose a target\n\n![Tell Agent target picker](https://raw.githubusercontent.com/omercnet/paseo-plugins/main/tell-agent/docs/images/tell-agent-picker.png)\n\n### Compose an instruction\n\n![Tell Agent instruction composer](https://raw.githubusercontent.com/omercnet/paseo-plugins/main/tell-agent/docs/images/tell-agent-compose.png)\n\n## Install\n\n### Paseo 0.9.0 or 0.10.1\n\nInstall the npm package:\n\n```bash\npaseo plugin install npm:@omercnet/paseo-tell-agent\n```\n\nUpdate an npm installation by its plugin ID:\n\n```bash\npaseo plugin update tell-agent\n```\n\nPaseo 0.9 and 0.10 use the reviewed update flow to show the current and proposed revisions before asking for approval. Add `--check` to preview without applying or `--yes` to skip the approval prompt.\n\n## Use\n\nRun the slash command from an agent composer:\n\n```text\n/tell [--interrupt] <agent or workspace> :: <message>\n```\n\nFor example:\n\n```text\n/tell Payments :: Review the authentication change.\n```\n\nThe target can match an active agent's title or ID, or its project or workspace name. Ambiguous matches must be refined.\n\n`tell-agent` only searches agents connected to the same Paseo daemon host. It does not discover or contact agents on other hosts.\n\nOn Paseo 0.12 and later, agents in background workspaces are hidden from discovery. They do not appear as targets, and their composers do not get the Tell agent button.\n\nThe plugin asks the source agent to forward the message to the resolved target. The source agent remains responsible for executing that instruction; the plugin does not inject the text directly into the target session.\n\nIf the source agent is busy, `/tell` and the Tell agent panel send that instruction with `activeTurnBehavior: \"steer\"`. Paseo tries to add it to the running turn instead of interrupting it, and the agent picks it up at its next step, which can be after its current tool call finishes. Steering is best effort: Paseo still replaces the turn when the provider cannot steer. Paseo 0.9 and later hosts accept both the steer and interrupt behaviors. Put `--interrupt` first to replace the source agent's current turn instead:\n\n```text\n/tell --interrupt Payments :: Stop and review the authentication change.\n```\n\nEither choice only applies to the source agent. Its later message to the target is a separate send. On Paseo 0.12 and later, an agent's send steers a running target by default and falls back to interrupting when the provider cannot steer. The target shows it as a message from the source agent. Tell the source agent to use `interrupt` if you want the target's turn replaced. Before 0.12, an agent's send always interrupts a running target.\n\n## Trust\n\nPaseo plugins run as trusted, unsandboxed code. Installing this package trusts its code, dependencies, and future updates. Review the package and update preview before approving an installation or update.\n"}