@link-assistant/agent 0.0.14 → 0.0.16

package/README.md

@@ -287,6 +287,110 @@ All 13 tools are **enabled by default** with **no configuration required**. See
 
 ✨ = Always enabled (no experimental flags or environment variables needed)
 
+## MCP (Model Context Protocol) Support
+
+The agent supports the Model Context Protocol (MCP), allowing you to extend functionality with MCP servers. MCP enables the agent to interact with external tools and services, such as browser automation via Playwright.
+
+### Installing Playwright MCP
+
+Microsoft's Playwright MCP server provides browser automation capabilities using Playwright. This enables the agent to interact with web pages through structured accessibility snapshots.
+
+**Requirements:**
+
+- Node.js 18 or newer (for running the Playwright MCP server)
+- Bun (for running the agent itself)
+
+**Installation:**
+
+```bash
+# Add Playwright MCP server to your agent configuration
+agent mcp add playwright npx @playwright/mcp@latest
+
+# Verify the configuration
+agent mcp list
+```
+
+This will create a configuration file at `~/.config/opencode/opencode.json` (or your system's config directory) with:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "playwright": {
+      "type": "local",
+      "command": ["npx", "@playwright/mcp@latest"],
+      "enabled": true
+    }
+  }
+}
+```
+
+**Available Playwright Tools:**
+
+Once configured, the agent gains access to 22+ browser automation tools:
+
+- `browser_navigate` - Navigate to a URL
+- `browser_click` - Click on an element
+- `browser_type` - Type text into an element
+- `browser_snapshot` - Capture accessibility snapshot
+- `browser_take_screenshot` - Take a screenshot
+- `browser_fill_form` - Fill multiple form fields
+- `browser_select_option` - Select dropdown option
+- `browser_hover` - Hover over element
+- `browser_drag` - Drag and drop
+- `browser_evaluate` - Execute JavaScript
+- `browser_tabs` - Manage browser tabs
+- `browser_close` - Close the browser
+- `browser_wait_for` - Wait for text/element
+- `browser_press_key` - Press keyboard key
+- `browser_handle_dialog` - Handle browser dialogs
+- `browser_network_requests` - Get network requests
+- `browser_console_messages` - Get console messages
+- `browser_file_upload` - Upload files
+- `browser_resize` - Resize browser window
+- `browser_navigate_back` - Navigate back
+- `browser_install` - Install browser
+- `browser_run_code` - Run Playwright code
+
+**Usage Example:**
+
+```bash
+# Tell the agent to navigate to a website and take a screenshot
+echo "Navigate to https://example.com and take a screenshot" | agent
+```
+
+The agent will automatically use the Playwright MCP tools when browser automation is needed.
+
+**Learn More:**
+
+- [Playwright MCP GitHub Repository](https://github.com/microsoft/playwright-mcp)
+- [Using Playwright MCP with Claude Code](https://til.simonwillison.net/claude-code/playwright-mcp-claude-code)
+- [Playwright MCP Case Study](docs/case-studies/playwright-mcp-support/case-study.md)
+
+### Managing MCP Servers
+
+**List configured servers:**
+
+```bash
+agent mcp list
+```
+
+**Add a remote MCP server:**
+
+```bash
+agent mcp add myserver --url https://example.com/mcp
+```
+
+**Interactive mode:**
+
+If you prefer an interactive setup, just run:
+
+```bash
+agent mcp add
+```
+
+The interactive prompt will guide you through configuring local or remote MCP servers.
+
 ## Examples
 
 See [EXAMPLES.md](EXAMPLES.md) for detailed usage examples of each tool with both agent-cli and opencode commands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",

package/src/cli/cmd/run.ts

@@ -109,11 +109,8 @@ export const RunCommand = cmd({
       });
   },
   handler: async (args) => {
-    // Set verbose mode if requested
-    if (args.verbose) {
-      Flag.setVerbose(true);
-      await Log.init({ print: true, level: 'DEBUG' });
-    }
+    // Note: verbose flag and logging are now initialized in middleware
+    // See src/index.js main() function for the middleware that sets up Flag and Log.init()
     let message = args.message.join(' ');
 
     const fileParts: any[] = [];

package/src/index.js

@@ -83,10 +83,8 @@ function readStdin() {
 }
 
 async function runAgentMode(argv) {
-  // Set verbose mode if requested via CLI flag
-  if (argv.verbose) {
-    Flag.setVerbose(true);
-  }
+  // Note: verbose flag and logging are now initialized in middleware
+  // See main() function for the middleware that sets up Flag and Log.init()
 
   // Parse model argument (handle model IDs with slashes like groq/qwen/qwen3-32b)
   const modelParts = argv.model.split('/');
@@ -176,13 +174,7 @@ async function runAgentMode(argv) {
     appendSystemMessage = await file.text();
   }
 
-  // Initialize logging to redirect to log file instead of stderr
-  // This prevents log messages from mixing with JSON output
-  // In verbose mode, print to stderr for debugging
-  await Log.init({
-    print: Flag.OPENCODE_VERBOSE, // Print to stderr only in verbose mode
-    level: Flag.OPENCODE_VERBOSE ? 'DEBUG' : 'INFO',
-  });
+  // Logging is already initialized in middleware, no need to call Log.init() again
 
   // Read input from stdin
   const input = await readStdin();
@@ -563,6 +555,22 @@ async function main() {
           'Use existing Claude OAuth credentials from ~/.claude/.credentials.json (from Claude Code CLI)',
         default: false,
       })
+      // Initialize logging early for all CLI commands
+      // This prevents debug output from appearing in CLI unless --verbose is used
+      .middleware(async (argv) => {
+        // Set verbose flag if requested
+        if (argv.verbose) {
+          Flag.setVerbose(true);
+        }
+
+        // Initialize logging system
+        // - If verbose: print logs to stderr for debugging
+        // - Otherwise: write logs to file to keep CLI output clean
+        await Log.init({
+          print: Flag.OPENCODE_VERBOSE,
+          level: Flag.OPENCODE_VERBOSE ? 'DEBUG' : 'INFO',
+        });
+      })
       .fail((msg, err, yargs) => {
         // Handle errors from command handlers
         if (err) {