@standardbeagle/agnt 0.5.1

package/README.md

@@ -0,0 +1,117 @@
+# agnt
+
+MCP server for AI coding agents - process management, reverse proxy with traffic logging, browser instrumentation, and sketch mode.
+
+## Installation
+
+```bash
+npm install -g @standardbeagle/agnt
+```
+
+## Quick Start
+
+### As MCP Server (Claude Code, etc.)
+
+Add to your Claude Code MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "agnt": {
+      "command": "agnt",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Or install as a Claude Code plugin:
+
+```bash
+/plugin marketplace add standardbeagle/agnt
+/plugin install agnt@agnt
+```
+
+### As PTY Wrapper
+
+Wrap your AI coding tool with overlay features:
+
+```bash
+agnt run claude --dangerously-skip-permissions
+agnt run gemini
+agnt run copilot
+```
+
+## Features
+
+- **Project Detection**: Auto-detect Go, Node.js, Python projects
+- **Process Management**: Run and manage long-running processes
+- **Reverse Proxy**: HTTP proxy with traffic logging
+- **Browser Instrumentation**: 50+ diagnostic primitives
+- **Sketch Mode**: Excalidraw-like wireframing on your UI
+- **Floating Indicator**: Quick access panel in browser
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `detect` | Detect project type and available scripts |
+| `run` | Run scripts or commands |
+| `proc` | Manage processes: status, output, stop, list |
+| `proxy` | Reverse proxy: start, stop, exec, toast |
+| `proxylog` | Query proxy traffic logs |
+| `currentpage` | View active page sessions |
+| `daemon` | Manage background daemon |
+
+## Usage Examples
+
+```
+# Start a proxy for your dev server
+proxy {action: "start", id: "dev", target_url: "http://localhost:3000"}
+
+# Execute JavaScript in connected browsers
+proxy {action: "exec", id: "dev", code: "__devtool.screenshot('homepage')"}
+
+# Show toast notification
+proxy {action: "toast", id: "dev", toast_message: "Build complete!", toast_type: "success"}
+```
+
+## Browser API
+
+The proxy injects `window.__devtool` with 50+ functions:
+
+- `screenshot(name)` - Capture screenshot
+- `inspect(selector)` - Get element info
+- `sketch.open()` / `sketch.save()` - Wireframe mode
+- `indicator.toggle()` - Toggle floating indicator
+- And many more...
+
+## Configuration
+
+Create `.agnt.kdl` in your project root:
+
+```kdl
+scripts {
+    dev {
+        command "npm"
+        args "run" "dev"
+        autostart true
+    }
+}
+
+proxies {
+    frontend {
+        target "http://localhost:3000"
+        autostart true
+    }
+}
+```
+
+## Documentation
+
+- [GitHub](https://github.com/standardbeagle/agnt)
+- [Documentation](https://standardbeagle.github.io/agnt/)
+
+## License
+
+MIT

package/bin/.gitkeep

@@ -0,0 +1 @@
+# Binary will be downloaded during npm install

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@standardbeagle/agnt",
+  "version": "0.5.1",
+  "description": "MCP server for AI coding agents - process management, reverse proxy with traffic logging, browser instrumentation, and sketch mode",
+  "main": "dist/index.js",
+  "bin": {
+    "agnt": "bin/agnt"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "development",
+    "devtools",
+    "proxy",
+    "debugging",
+    "frontend",
+    "diagnostics",
+    "sketch",
+    "wireframe",
+    "process-management",
+    "claude-code"
+  ],
+  "author": "Standard Beagle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/standardbeagle/agnt.git"
+  },
+  "bugs": {
+    "url": "https://github.com/standardbeagle/agnt/issues"
+  },
+  "homepage": "https://standardbeagle.github.io/agnt/",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+
+const VERSION = '0.5.1';
+const REPO = 'standardbeagle/agnt';
+const BINARY_NAME = 'agnt';
+
+// Platform/architecture mapping
+const PLATFORMS = {
+  darwin: 'darwin',
+  linux: 'linux',
+  win32: 'windows',
+};
+
+const ARCHS = {
+  x64: 'amd64',
+  arm64: 'arm64',
+};
+
+function getPlatform() {
+  const platform = PLATFORMS[process.platform];
+  if (!platform) {
+    throw new Error(`Unsupported platform: ${process.platform}`);
+  }
+  return platform;
+}
+
+function getArch() {
+  const arch = ARCHS[process.arch];
+  if (!arch) {
+    throw new Error(`Unsupported architecture: ${process.arch}`);
+  }
+  return arch;
+}
+
+function getBinaryName() {
+  return process.platform === 'win32' ? `${BINARY_NAME}.exe` : BINARY_NAME;
+}
+
+function getDownloadUrl() {
+  const platform = getPlatform();
+  const arch = getArch();
+  const ext = platform === 'windows' ? '.exe' : '';
+
+  // GitHub release asset URL pattern
+  return `https://github.com/${REPO}/releases/download/v${VERSION}/${BINARY_NAME}-${platform}-${arch}${ext}`;
+}
+
+async function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    const protocol = url.startsWith('https') ? https : http;
+
+    const request = protocol.get(url, (response) => {
+      // Handle redirects
+      if (response.statusCode === 301 || response.statusCode === 302) {
+        file.close();
+        fs.unlinkSync(dest);
+        downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(dest);
+        reject(new Error(`Failed to download: ${response.statusCode} ${response.statusMessage}`));
+        return;
+      }
+
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    });
+
+    request.on('error', (err) => {
+      file.close();
+      fs.unlinkSync(dest);
+      reject(err);
+    });
+  });
+}
+
+async function install() {
+  const binDir = path.join(__dirname, '..', 'bin');
+  const binaryPath = path.join(binDir, getBinaryName());
+
+  // Create bin directory if it doesn't exist
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  // Check if binary already exists
+  if (fs.existsSync(binaryPath)) {
+    console.log(`${BINARY_NAME} binary already exists, skipping download`);
+    return;
+  }
+
+  const url = getDownloadUrl();
+  console.log(`Downloading ${BINARY_NAME} v${VERSION}...`);
+  console.log(`  Platform: ${getPlatform()}`);
+  console.log(`  Architecture: ${getArch()}`);
+  console.log(`  URL: ${url}`);
+
+  try {
+    await downloadFile(url, binaryPath);
+
+    // Make executable on Unix
+    if (process.platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`Successfully installed ${BINARY_NAME} to ${binaryPath}`);
+  } catch (error) {
+    console.error(`Failed to download ${BINARY_NAME}:`);
+    console.error(error.message);
+    console.error('');
+    console.error('You can manually download the binary from:');
+    console.error(`  https://github.com/${REPO}/releases/tag/v${VERSION}`);
+    console.error('');
+    console.error('Or build from source:');
+    console.error(`  git clone https://github.com/${REPO}.git`);
+    console.error('  cd agnt');
+    console.error('  make build');
+    process.exit(1);
+  }
+}
+
+install().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});