fastbrowser_cli 1.0.2 → 1.0.3

package/src/{fastweb_cli/fastweb_cli.ts → fastbrowser_cli/fastbrowser_cli.ts}

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 
+// node imports
+import fs from 'node:fs';
+import path from 'node:path';
+
 // npm imports
 import { Command } from 'commander';
 
 // local imports
 import { HttpClient } from './libs/http-client.js';
 import { ServerManager } from './libs/server-manager.js';
-import type { QuerySelectorInput, QuerySelectorFirstInput, QuerySelectorsAllRequest, QuerySelectorRequest } from '../fastweb_http_server/libs/tool-schemas.js';
+import type { QuerySelectorInput, QuerySelectorFirstInput, QuerySelectorsAllRequest, QuerySelectorRequest } from '../fastbrowser_httpd/libs/tool-schemas.js';
 
 
 ///////////////////////////////////////////////////////////////////////////////
@@ -40,7 +44,7 @@ async function runTool(cmd: Command, routeName: string, body: unknown): Promise<
 		HttpClient.printResponse(response);
 	} catch (err) {
 		const message = err instanceof Error ? err.message : String(err);
-		console.error(`fastweb-cli error: ${message}`);
+		console.error(`fastbrowser-cli error: ${message}`);
 		process.exit(1);
 	}
 }
@@ -127,54 +131,84 @@ function buildQuerySelectorFirstBody(opts: {
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
 
+async function runInstall(skillFolder: string): Promise<void> {
+	const sourceSkillMd = path.resolve(__dirname, '../../skills/fastbrowser/SKILL.md');
+	const targetDir = path.resolve(skillFolder, 'skills', 'fastbrowser');
+	const targetSkillMd = path.join(targetDir, 'SKILL.md');
+	try {
+		await fs.promises.mkdir(targetDir, { recursive: true });
+		await fs.promises.copyFile(sourceSkillMd, targetSkillMd);
+		console.log(`Installed fastbrowser SKILL.md at ${targetSkillMd}`);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		console.error(`fastbrowser-cli error: ${message}`);
+		process.exit(1);
+	}
+}
+
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+
 async function main(): Promise<void> {
+	const installIdx = process.argv.indexOf('--install');
+	if (installIdx !== -1) {
+		const next = process.argv[installIdx + 1];
+		const skillFolder = (next !== undefined && next.startsWith('-') === false) ? next : '.';
+		await runInstall(skillFolder);
+		return;
+	}
+
 	const program = new Command();
 	program
-		.name('fastweb-cli')
-		.description('CLI client for fastweb-http-server2')
-		.option('--server <url>', 'fastweb-http-server URL (default: env FASTWEB_SERVER or http://localhost:8787)')
+		.name('fastbrowser-cli')
+		.description('CLI client for fastbrowser')
+		.option('--server <url>', 'fastbrowser-httpd URL (default: env FASTBROWSER_SERVER or http://localhost:8787)')
 		.option('--autostart', 'Auto-start the server before a command if it is not running', true)
-		.option('--no-autostart', 'Do not auto-start the server before a command');
+		.option('--no-autostart', 'Do not auto-start the server before a command')
+		.option('--install [skill-folder]', 'Install SKILL.md into <skill-folder>/skills/fastbrowser (default: .)');
 
 	const serverCmd = program
 		.command('server')
-		.description('Manage the fastweb HTTP server');
+		.description('Manage the fastbrowser HTTP server');
 
 	serverCmd
 		.command('start')
-		.description('Start the fastweb HTTP server as a detached daemon')
+		.description('Start the fastbrowser HTTP server as a detached daemon')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			try {
 				await ServerManager.start(server);
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				console.error(`fastweb-cli error: ${message}`);
+				console.error(`fastbrowser-cli error: ${message}`);
 				process.exit(1);
 			}
 		});
 
 	serverCmd
 		.command('stop')
-		.description('Stop the fastweb HTTP server')
+		.description('Stop the fastbrowser HTTP server')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			try {
 				await ServerManager.stop(server);
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
-				console.error(`fastweb-cli error: ${message}`);
+				console.error(`fastbrowser-cli error: ${message}`);
 				process.exit(1);
 			}
 		});
 
 	serverCmd
 		.command('status')
-		.description('Report whether the fastweb HTTP server is running')
+		.description('Report whether the fastbrowser HTTP server is running')
 		.action(async (_opts, cmd: Command) => {
 			const server = getServerFromCmd(cmd);
 			const state = await ServerManager.status(server);
-			console.log(`fastweb server at ${server}: ${state}`);
+			console.log(`fastbrowser server at ${server}: ${state}`);
 			if (state === 'stopped') process.exit(1);
 		});
 
@@ -254,7 +288,7 @@ async function main(): Promise<void> {
 			try {
 				body = buildQuerySelectorsBody(opts);
 			} catch (err) {
-				console.error(`fastweb-cli error: ${(err as Error).message}`);
+				console.error(`fastbrowser-cli error: ${(err as Error).message}`);
 				process.exit(1);
 			}
 			await runTool(cmd, 'query_selectors_all', body);
@@ -279,7 +313,7 @@ async function main(): Promise<void> {
 			try {
 				body = buildQuerySelectorFirstBody(opts);
 			} catch (err) {
-				console.error(`fastweb-cli error: ${(err as Error).message}`);
+				console.error(`fastbrowser-cli error: ${(err as Error).message}`);
 				process.exit(1);
 			}
 			await runTool(cmd, 'query_selectors', body);

package/src/{fastweb_cli → fastbrowser_cli}/libs/http-client.ts

@@ -1,5 +1,5 @@
 // local imports
-import { ToolResponseSchema, type ToolResponse } from '../../fastweb_http_server/libs/tool-schemas.js';
+import { ToolResponseSchema, type ToolResponse } from '../../fastbrowser_httpd/libs/tool-schemas.js';
 
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
@@ -10,7 +10,7 @@ import { ToolResponseSchema, type ToolResponse } from '../../fastweb_http_server
 export class HttpClient {
 	static getServerUrl(overrideUrl: string | undefined): string {
 		if (overrideUrl !== undefined && overrideUrl !== '') return overrideUrl;
-		const envUrl = process.env.FASTWEB_SERVER;
+		const envUrl = process.env.FASTBROWSER_SERVER;
 		if (envUrl !== undefined && envUrl !== '') return envUrl;
 		return 'http://localhost:8787';
 	}

package/src/{fastweb_cli → fastbrowser_cli}/libs/server-manager.ts

@@ -16,7 +16,7 @@ type PidFile = {
 	startedAt: string;
 };
 
-const STATE_DIR = Path.join(Os.homedir(), '.fastweb_cli');
+const STATE_DIR = Path.join(Os.homedir(), '.fastbrowser_cli');
 const PID_FILE = Path.join(STATE_DIR, 'server.json');
 const LOG_FILE = Path.join(STATE_DIR, 'server.log');
 
@@ -47,7 +47,7 @@ export class ServerManager {
 		if (state === 'running') return;
 
 		if (ServerManager.isLocalUrl(serverUrl) === false) {
-			throw new Error(`fastweb server at ${serverUrl} is not reachable and cannot be auto-started (non-local URL)`);
+			throw new Error(`fastbrowser server at ${serverUrl} is not reachable and cannot be auto-started (non-local URL)`);
 		}
 		await ServerManager.start(serverUrl);
 	}
@@ -55,7 +55,7 @@ export class ServerManager {
 	static async start(serverUrl: string): Promise<void> {
 		const existing = await ServerManager.status(serverUrl);
 		if (existing === 'running') {
-			console.error(`fastweb server already running at ${serverUrl}`);
+			console.error(`fastbrowser server already running at ${serverUrl}`);
 			return;
 		}
 
@@ -64,7 +64,7 @@ export class ServerManager {
 		}
 
 		const port = ServerManager.parsePort(serverUrl);
-		const entryPath = Path.resolve(__dirname, '..', '..', 'fastweb_http_server', 'fastweb_http_server.ts');
+		const entryPath = Path.resolve(__dirname, '..', '..', 'fastbrowser_httpd', 'fastbrowser_httpd.ts');
 		const packageRoot = Path.resolve(__dirname, '..', '..', '..');
 
 		Fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -81,7 +81,7 @@ export class ServerManager {
 		const pid = child.pid;
 		if (pid === undefined) {
 			Fs.closeSync(logFd);
-			throw new Error('Failed to spawn fastweb-http-server (no pid)');
+			throw new Error('Failed to spawn fastbrowser-httpd (no pid)');
 		}
 
 		const pidFile: PidFile = {
@@ -96,7 +96,7 @@ export class ServerManager {
 			const state = await ServerManager.status(serverUrl);
 			if (state === 'running') {
 				Fs.closeSync(logFd);
-				console.error(`fastweb server started (pid=${pid}, port=${port})`);
+				console.error(`fastbrowser server started (pid=${pid}, port=${port})`);
 				return;
 			}
 			await ServerManager.sleep(500);
@@ -104,7 +104,7 @@ export class ServerManager {
 
 		Fs.closeSync(logFd);
 		const tail = ServerManager.readLogTail(50);
-		throw new Error(`fastweb server did not become healthy within 10s. Log tail:\n${tail}`);
+		throw new Error(`fastbrowser server did not become healthy within 10s. Log tail:\n${tail}`);
 	}
 
 	static async stop(serverUrl: string): Promise<void> {
@@ -157,7 +157,7 @@ export class ServerManager {
 			console.error(`warning: process ${pid} killed but ${serverUrl} still responds to /health`);
 			return;
 		}
-		console.error('fastweb server stopped');
+		console.error('fastbrowser server stopped');
 	}
 
 	private static isLocalUrl(serverUrl: string): boolean {

package/src/{fastweb_http_server/fastweb_http_server.ts → fastbrowser_httpd/fastbrowser_httpd.ts}

@@ -8,7 +8,7 @@ import { Command } from 'commander';
 import express from 'express';
 
 // local imports
-import { McpClient } from '../fastweb_mcp/libs/mcp_client.js';
+import { McpClient } from '../fastbrowser_mcp/libs/mcp_client.js';
 import { Routes } from './libs/routes.js';
 
 ///////////////////////////////////////////////////////////////////////////////
@@ -25,25 +25,25 @@ class MainHelper {
 		port: number;
 		verbose?: boolean;
 	}): Promise<void> {
-		// Spawn fastweb-mcp as a subprocess and hold a persistent MCP client to it.
-		const fastwebMcpEntry = Path.resolve(__dirname, '..', 'fastweb_mcp', 'fastweb_mcp.ts');
+		// Spawn fastbrowser-mcp as a subprocess and hold a persistent MCP client to it.
+		const fastbrowserMcpEntry = Path.resolve(__dirname, '..', 'fastbrowser_mcp', 'fastbrowser_mcp.ts');
 		const mcpClient = new McpClient({
-			name: 'fastweb-http-server',
+			name: 'fastbrowser-httpd',
 			version: '1.0.0',
 			transport: {
 				type: 'stdio',
 				command: 'npx',
-				args: ['tsx', fastwebMcpEntry, 'mcp_server'],
+				args: ['tsx', fastbrowserMcpEntry, 'mcp_server'],
 			},
 		});
 
-		console.error('Connecting to fastweb-mcp ...');
+		console.error('Connecting to fastbrowser-mcp ...');
 		await mcpClient.connect();
 		console.error('MCP client connected');
 
 		if (verbose) {
 			const tools = await mcpClient.listTools();
-			console.error('Tools available in fastweb-mcp:');
+			console.error('Tools available in fastbrowser-mcp:');
 			for (const tool of tools) {
 				console.error(`- ${tool.name}`);
 			}
@@ -54,7 +54,7 @@ class MainHelper {
 		Routes.register(app, mcpClient);
 
 		const server = app.listen(port, () => {
-			console.error(`fastweb-http-server listening on http://localhost:${port}`);
+			console.error(`fastbrowser-httpd listening on http://localhost:${port}`);
 		});
 
 		const shutdown = async (signal: string): Promise<void> => {
@@ -78,8 +78,8 @@ async function main(): Promise<void> {
 	const program = new Command();
 
 	program
-		.name('fastweb-http-server')
-		.description('Persistent HTTP server fronting fastweb-mcp')
+		.name('fastbrowser-httpd')
+		.description('Persistent HTTP server fronting fastbrowser-mcp')
 		.option('-p, --port <number>', 'Port to listen on', '8787')
 		.option('-v, --verbose', 'Enable verbose logging')
 		.action(async (opts: { port: string; verbose?: boolean }) => {

package/src/{fastweb_http_server → fastbrowser_httpd}/libs/routes.ts

@@ -2,7 +2,7 @@
 import type { Express, Request, Response } from 'express';
 
 // local imports
-import { McpClient } from '../../fastweb_mcp/libs/mcp_client.js';
+import { McpClient } from '../../fastbrowser_mcp/libs/mcp_client.js';
 import { TOOL_SCHEMAS, ToolResponseSchema } from './tool-schemas.js';
 
 ///////////////////////////////////////////////////////////////////////////////

package/src/{fastweb_http_server → fastbrowser_httpd}/libs/tool-schemas.ts

@@ -2,13 +2,13 @@
 import { z } from 'zod';
 
 // local imports - reuse the authoritative query selector schemas
-import { QuerySelectorsInputSchema, QuerySelectorsFirstInputSchema } from '../../fastweb_mcp/libs/schemas.js';
-export type { QuerySelectorInput, QuerySelectorsInput, QuerySelectorFirstInput, QuerySelectorsFirstInput } from '../../fastweb_mcp/libs/schemas.js';
+import { QuerySelectorsInputSchema, QuerySelectorsFirstInputSchema } from '../../fastbrowser_mcp/libs/schemas.js';
+export type { QuerySelectorInput, QuerySelectorsInput, QuerySelectorFirstInput, QuerySelectorsFirstInput } from '../../fastbrowser_mcp/libs/schemas.js';
 
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
 //	Request schemas — one per tool. Shapes mirror what the underlying
-//	fastweb-mcp tools accept. For the proxied chrome-devtools-mcp tools,
+//	fastbrowser-mcp tools accept. For the proxied chrome-devtools-mcp tools,
 //	the shapes come from chrome-devtools-mcp's tool reference.
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
@@ -85,7 +85,7 @@ export type ToolResponse = z.infer<typeof ToolResponseSchema>;
 ///////////////////////////////////////////////////////////////////////////////
 
 // The REST route name (snake_case, matches the CLI command) is distinct from
-// the underlying MCP tool name (which may be camelCase for fastweb-mcp's own
+// the underlying MCP tool name (which may be camelCase for fastbrowser-mcp's own
 // tools). `mcpToolName` is what we send over MCP; `routeName` is the URL path.
 export type ToolSchemaEntry = {
 	routeName: string;

package/src/{fastweb_mcp → fastbrowser_mcp}/libs/mcp_proxy.ts

@@ -14,7 +14,7 @@ export class McpProxy {
 
 	constructor() {
 		this._mcpServer = new McpServer({
-			name: "fastweb_mcp",
+			name: "fastbrowser_mcp",
 			version: "1.0.0",
 		});
 	}

package/src/{fastweb_mcp → fastbrowser_mcp}/libs/schemas.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////
 //	Authoritative query selector schemas — shared between the MCP server
-//	and the HTTP/CLI layer. Kept out of the fastweb_mcp.ts entrypoint so
+//	and the HTTP/CLI layer. Kept out of the fastbrowser_mcp.ts entrypoint so
 //	importing the schemas does not execute the CLI's top-level `main()`.
 ///////////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////////

package/tmp/.claude/skills/fastweb/SKILL.md

@@ -15,7 +15,7 @@ maps 1-to-1 to a FastWeb tool and returns the tool's response on stdout.
 Run the CLI directly via `tsx`:
 
 ```bash
-npx tsx ../src/fastweb_cli/fastweb_cli.ts <command> [flags]
+npx fastbrowser_cli <command> [flags]
 ```
 
 ## Typical Workflow
@@ -35,16 +35,16 @@ uid=1_0 RootWebArea "Example Domain" url="https://example.com/"
 
 ```bash
 # List all open browser pages
-npx tsx ../src/fastweb_cli/fastweb_cli.ts list_pages
+npx fastbrowser_cli list_pages
 
 # Open a new page at a URL
-npx tsx ../src/fastweb_cli/fastweb_cli.ts new_page --url https://example.com
+npx fastbrowser_cli new_page --url https://example.com
 
 # Close a page by its numeric id
-npx tsx ../src/fastweb_cli/fastweb_cli.ts close_page --page-id 1
+npx fastbrowser_cli close_page --page-id 1
 
 # Navigate the current page to a URL
-npx tsx ../src/fastweb_cli/fastweb_cli.ts navigate_page --url https://example.com
+npx fastbrowser_cli navigate_page --url https://example.com
 ```
 
 
@@ -150,44 +150,44 @@ Example queries on it:
 
 ```bash
 # Query the accessibility tree returning the FIRST match per selector (--selector is repeatable)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors --selector "button" --selector "link"
+npx fastbrowser_cli query_selectors --selector "button" --selector "link"
 
 # Exclude ancestor nodes from the result
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors --selector 'heading[level="1"]' --no-with-ancestors
+npx fastbrowser_cli query_selectors --selector 'heading[level="1"]' --no-with-ancestors
 
 # Per-selector control over withAncestors via JSON
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors \
+npx fastbrowser_cli query_selectors \
   --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
 
 # Query the accessibility tree returning ALL matches per selector (--selector is repeatable)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector "button" --selector "link" --limit 5
+npx fastbrowser_cli query_selectors_all --selector "button" --selector "link" --limit 5
 
 # Exclude ancestor nodes from the result
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
+npx fastbrowser_cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
 
 # Per-selector control over limit / withAncestors via JSON
-npx tsx ../src/fastweb_cli/fastweb_cli.ts query_selectors_all \
+npx fastbrowser_cli query_selectors_all \
   --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
 
 # Take an accessibility-tree full page snapshot of the current page - very expensive, prefer targeted queries when possible
-npx tsx ../src/fastweb_cli/fastweb_cli.ts take_snapshot
+npx fastbrowser_cli take_snapshot
 ```
 
 ## Interaction
 
 ```bash
 # Click by a direct uid reference (fast path - no accessibility-tree lookup)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts click --selector "#1_42"
+npx fastbrowser_cli click --selector "#1_42"
 
 # Click by any CSS-like selector - resolved to a uid internally
-npx tsx ../src/fastweb_cli/fastweb_cli.ts click -s 'button[name="Submit"]'
+npx fastbrowser_cli click -s 'button[name="Submit"]'
 
 # Fill a single form field - selector can be a uid (#1_7) or any CSS-like selector
-npx tsx ../src/fastweb_cli/fastweb_cli.ts fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
+npx fastbrowser_cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
 
 # Press a comma-separated sequence of keys (literals and named keys both work)
-npx tsx ../src/fastweb_cli/fastweb_cli.ts press_keys --keys "Tab, Tab, Enter"
-npx tsx ../src/fastweb_cli/fastweb_cli.ts press_keys --keys "Hello, Tab, Enter"
+npx fastbrowser_cli press_keys --keys "Tab, Tab, Enter"
+npx fastbrowser_cli press_keys --keys "Hello, Tab, Enter"
 ```
 
 ## Command Reference