{"id":"terminal-integration","repo":"keefeere/paseo-terminal-integration","url":"https://github.com/keefeere/paseo-terminal-integration","package":"paseo-terminal-integration","npm":{"package":"paseo-terminal-integration","version":"0.1.0","integrity":"sha512-bbn2eus7xHwgQMY1kWofMAyn77Y9Cil/fz9PBCaJE1a75zz4MmjneQ250TBfxD0KMyN7g1I4EAdM4hLcuPaiaQ==","publishedAt":"2026-09-29T15:15:23.098Z","downloadsLast30Days":0},"name":"terminal-integration","description":"Run agent code blocks in a Paseo terminal and send the output back to the agent; attach terminal output to prompts","categories":["automation","productivity"],"platforms":["macos","linux"],"caveats":["Requires Paseo 0.10.1 or later","Needs bash on the daemon host, plus python3 or node for those code blocks","Runs commands in a real terminal on the daemon host, only when you press Run or submit /run"],"images":[],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":false,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-30T04:17:55.679Z","addedAt":"2026-09-30T07:13:49+03:00","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-30T04:17:24.381Z","version":"0.1.0","integrity":"sha512-bbn2eus7xHwgQMY1kWofMAyn77Y9Cil/fz9PBCaJE1a75zz4MmjneQ250TBfxD0KMyN7g1I4EAdM4hLcuPaiaQ=="},"version":"0.1.0","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-30T04:17:24.381Z","commit":"dce35f7732a6989d795efc020c3a28ff4e72102d"},"author":"Chechulin Serhii","license":"MIT","paseoVersionRequirement":">=0.10.1","descriptionNodes":[{"type":"text","text":"Run agent code blocks in a Paseo terminal and send the output back to the agent; attach terminal output to prompts"}],"caveatNodes":[[{"type":"text","text":"Requires Paseo 0.10.1 or later"}],[{"type":"text","text":"Needs bash on the daemon host, plus python3 or node for those code blocks"}],[{"type":"text","text":"Runs commands in a real terminal on the daemon host, only when you press Run or submit /run"}]],"manifest":{"id":"terminal-integration","description":"Run agent code blocks in a Paseo terminal and send terminal output back to the agent","requirements":{"paseo":">=0.10.1"}},"repoMeta":{"stars":1,"defaultBranch":"main","pushedAt":"2026-09-29T14:08:46Z"},"owner":{"login":"keefeere","avatarUrl":"https://avatars.githubusercontent.com/u/78239416?v=4"},"installNotesHtml":"
Requires Paseo 0.10.1 or later and a macOS or Linux daemon host with bash (plus python3 or\nnode for those blocks). Enable plugins under Settings → Plugins, then:
Output is read from the terminal screen, so very long lines arrive wrapped and only the last\n3,000 rows are visible. The agent receives at most 300 lines or 24,000 characters.
\n
Run state lives in the plugin process; reloading the plugin forgets it (the cards stay).
\n
A command that has not started within 20 seconds fails, for example when something else is\nrunning in \"Agent commands\".
\n
","readmeText":"# Terminal integration for Paseo\n\nTwo-way bridge between agent chats and Paseo terminals.\n\n**Agent → terminal.** When a turn ends, runnable fenced code blocks in the agent's reply\n(`bash`, `sh`, `shell`, `console`, `zsh`, `fish`, `python`, `js`/`node`) get a **Run in terminal**\ncard under the reply:\n\n- **Run & send to agent** runs the block in the workspace terminal \"Agent commands\" and, when it\n finishes, sends the command, exit code, and output to the agent as a new message. If the agent is\n busy, delivery waits until its turn ends instead of interrupting it.\n- **Run only** runs it without sending; **Send output** sends it later.\n- **Stop** sends Ctrl-C; **Send output so far** reports a still-running command.\n\nThe terminal is a real PTY, so prompts (`sudo`, `y/n`) can be answered in the terminal tab. Runs in\none workspace are queued so a command never types into another one's stdin. Each block runs as a\nscript in the agent's working directory, so `cd` and `export` do not persist between runs.\n\n**Terminal → agent.** In the composer's attachment menu, **Terminal output** attaches the latest\nlines of any terminal on the daemon. Type part of a name or path to filter, and a number to choose\nthe line count (`build 500`; default 200).\n\n## Install\n\nRequires Paseo 0.10.1 or later and a macOS or Linux daemon host with `bash` (plus `python3` or\n`node` for those blocks). Enable plugins under **Settings → Plugins**, then:\n\n```bash\npaseo plugin install npm:paseo-terminal-integration\n# or from GitHub\npaseo plugin install github:keefeere/paseo-terminal-integration\n```\n\nPlugins are trusted, unsandboxed code: this one types commands into terminals on the daemon host.\nNothing runs until you press a button or submit `/run`.\n\n## Commands\n\n| Command | Effect |\n| ----------------------------------------------- | ----------------------------------------------------------- |\n| `/run ` | Run a shell command and send its output to the agent |\n| `/blocks` | Add a run card for the latest reply (e.g. older chats) |\n| ⌘K / Ctrl+K → \"Terminal: add run buttons to …\" | Same as `/blocks` |\n\n## Limitations\n\n- Output is read from the terminal screen, so very long lines arrive wrapped and only the last\n 3,000 rows are visible. The agent receives at most 300 lines or 24,000 characters.\n- Run state lives in the plugin process; reloading the plugin forgets it (the cards stay).\n- A command that has not started within 20 seconds fails, for example when something else is\n running in \"Agent commands\".\n\n## Develop\n\n```bash\nnpm install\nnpm run typecheck\npaseo plugin install \"$PWD\" # first time\npaseo plugin reload terminal-integration\npaseo plugin logs terminal-integration\n```\n\n## License\n\nMIT\n"}