agentp 0.1.1 → 0.1.2

package/.ocmux.json

@@ -0,0 +1 @@
+{"url":"http://127.0.0.1:4096","logfile":"/tmp/opencode-serve-6cdb98e4626e.log","window_index":1}

package/AGENTS.md

@@ -0,0 +1,38 @@
+# agentp — agent notes
+
+## What it is
+
+Single-file Node.js CLI (`bin/agentp`) that pipes stdin into a running OpenCode TUI session and streams the assistant answer to stdout. Zero npm dependencies, CommonJS, no build step.
+
+## Entrypoint
+
+`bin/agentp` — the only source file. No other modules.
+
+## Commands
+
+| Action | Command |
+|---|---|
+| Dev install | `npm link` or `npm install -g .` |
+| Run | `printf "prompt" \| agentp` |
+
+No tests, no lint, no typecheck, no codegen. `npm test` is a noop placeholder.
+
+## Requirements
+
+- Node.js 18+
+- `opencode --serve` running locally (default port `4096`). See `.ocmux.json` for the local server URL/log path.
+- `opencode --attach` optional but useful to monitor conversations.
+
+## Architecture
+
+- Communicates with OpenCode via HTTP: `/tui/clear-prompt`, `/tui/append-prompt`, `/tui/submit-prompt`, `/event` (SSE).
+- Default server `http://localhost:4096`; override as positional arg with a port number (`agentp 4097`) or full URL (`agentp http://host:4096`)
+- `--qa` flag prints human/agent separator rows before streaming output.
+- Streams assistant `text` parts from SSE, filters out user echo by tracking `message.updated` events with role `user`.
+- Stops on `session.idle` event.
+
+## Gotchas
+
+- Stdin is consumed line-byline via `readline`. Each line is sent as a separate `append-prompt` request (no batching).
+- The script does NOT handle OpenCode not being running — it will crash with a connection error.
+- No test suite exists; manual testing via `printf "hi" | node bin/agentp`.

package/README.md

@@ -1,5 +1,10 @@
 # agentp
 
+[![npm version](https://img.shields.io/npm/v/agentp.svg)](https://www.npmjs.com/package/agentp)
+[![npm license](https://img.shields.io/npm/l/agentp.svg)](https://www.npmjs.com/package/agentp)
+[![npm downloads](https://img.shields.io/npm/dm/agentp.svg)](https://www.npmjs.com/package/agentp)
+[![node version](https://img.shields.io/node/v/agentp.svg)](https://www.npmjs.com/package/agentp)
+
 `agentp` is a tiny CLI that pipes prompt text into a running OpenCode TUI session and streams the assistant final answer back to stdout.
 
 It is designed for prompt-driven workflows where you want to do things like:
@@ -37,7 +42,7 @@ Notes:
 ## Usage
 
 ```bash
-agentp [options] [port]
+agentp [options] [url]
 ```
 
 Options:
@@ -47,7 +52,7 @@ Options:
 
 Arguments:
 
-- `port`: OpenCode TUI port (defaults to `4096`)
+- `url`: OpenCode TUI server URL or port number (defaults to `4096`). Examples: `4096`, `http://localhost:4096`, `http://192.168.1.50:4096`
 
 ## Examples
 
@@ -82,6 +87,12 @@ Capture answer to a file:
 cat prompt.txt | agentp > answer.txt
 ```
 
+Connect to a remote OpenCode server:
+
+```bash
+cat prompt.txt | agentp http://192.168.1.50:4096
+```
+
 From Vim/Neovim, send the current visual selection and replace it in place with the assistant answer:
 
 ```vim

package/bin/agentp

@@ -46,8 +46,7 @@ async function submitPrompt(server) {
   await makeRequest(buildJsonRequest(url, 'POST', '{}'), '{}');
 }
 
-async function sendPrompt(port) {
-  const server = `http://localhost:${port}`;
+async function sendPrompt(server) {
   let promptText = '';
 
   await clearPrompt(server);
@@ -70,9 +69,9 @@ const HUMAN_ROW = '👤: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣
 const AGENT_ROW = '🤖: ￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n'
 const FINAL_ROW = '￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣\n';
 
-function listenForFinalAnswer(port, showFinalRow) {
+function listenForFinalAnswer(server, showFinalRow) {
   return new Promise((resolve, reject) => {
-    const url = `http://localhost:${port}/event`;
+    const url = `${server}/event`;
     const parsed = new URL(url);
 
     const req = http.request({
@@ -154,36 +153,39 @@ function listenForFinalAnswer(port, showFinalRow) {
 }
 
 async function main() {
-  let port = 4096;
+  let serverBase = 'http://localhost:4096';
   let qaMode = false;
 
   const args = process.argv.slice(2);
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--help') {
-      console.error('Usage: agentp [options] [port]');
+      console.error('Usage: agentp [options] [url]');
       console.error('');
-      console.error('Pipe prompt text to an OpenCode TUI session running on localhost.');
-      console.error('The assistant response is streamed to stdout.');
+      console.error('Pipe prompt text to an OpenCode TUI session and stream the assistant response to stdout.');
       console.error('');
       console.error('Options:');
       console.error('  --qa       Print question/answer separators before streaming output');
       console.error('  --help     Show this help message');
       console.error('');
       console.error('Arguments:');
-      console.error('  port       OpenCode TUI port (default: 4096)');
+      console.error('  url        OpenCode TUI server URL or port number (default: 4096)');
+      console.error('             Examples: 4096, http://localhost:4096, http://192.168.1.50:4096');
       console.error('');
       console.error('Examples:');
       console.error('  printf "Summarize this file" | agentp');
       console.error('  cat prompt.txt | agentp --qa 4096');
+      console.error('  cat prompt.txt | agentp http://192.168.1.50:4096');
       process.exit(0);
     } else if (args[i] === '--qa') {
       qaMode = true;
-    } else if (!isNaN(args[i]) && /^\d+$/.test(args[i])) {
-      port = parseInt(args[i], 10);
+    } else if (args[i].includes('://')) {
+      serverBase = args[i].replace(/\/+$/, '');
+    } else if (/^\d+$/.test(args[i])) {
+      serverBase = 'http://localhost:' + args[i];
     }
   }
 
-  const promptText = await sendPrompt(port);
+  const promptText = await sendPrompt(serverBase);
 
   if (qaMode) {
     process.stdout.write(HUMAN_ROW);
@@ -191,7 +193,7 @@ async function main() {
     process.stdout.write(AGENT_ROW);
   }
 
-  await listenForFinalAnswer(port, qaMode);
+  await listenForFinalAnswer(serverBase, qaMode);
 }
 
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Pipe prompts into a running OpenCode TUI session and stream the final answer",
   "bin": {
     "agentp": "bin/agentp"