mirror of
https://github.com/browseros-ai/BrowserOS.git
synced 2026-05-20 20:39:10 +00:00
* feat: add browseros-cli Go CLI for browser automation Implements a full-featured CLI that communicates with the BrowserOS MCP server over JSON-RPC 2.0 / StreamableHTTP. Covers all 54 MCP tools across 10 categories with a hybrid command structure (flat verbs for hot-path commands, grouped noun-verb for resource management). - MCP client with initialize + tools/call pattern, thread-safe request IDs - Dual output: human-readable default, --json for structured/piped usage - Implicit active page resolution with --page override - 21 command files: open, nav, snap, click, fill, scroll, eval, ss, pdf, dom, wait, dialog, pages, window, bookmark, history, group, health, info - Cobra CLI framework with fatih/color for terminal formatting Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * test: add end-to-end integration tests for browseros-cli Go integration tests gated by `//go:build integration` that exercise the CLI binary against a running BrowserOS server. Tests build the binary, run commands via exec.Command, and verify JSON output. Covers: health, version, page lifecycle (open → text → snap → eval → screenshot → nav → reload → close), active page, info, error handling, and invalid page ID rejection. Skips gracefully when no server is running. Run with: go test -tags integration -v ./... Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * feat: add init command and fix MCP client bugs - Add `browseros-cli init` command that prompts for the server URL, verifies connectivity, and saves to ~/.config/browseros-cli/config.json - Config priority: --server flag > BROWSEROS_URL env > config file > default - Fix Accept header: include text/event-stream (required by StreamableHTTPTransport) - Fix nil args: send empty object {} instead of null for tools with no params - Update error messages to suggest `browseros-cli init` on connection failure Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add README for browseros-cli with setup, usage, and testing guide Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: always send arguments object in MCP tools/call Go's json omitempty omits empty maps, causing the arguments field to be missing from tools/call requests. The MCP SDK requires arguments to be an object (even empty {}), not undefined. Remove omitempty from the tag. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * feat: update help menu to be have groups * refactor: replace hand-rolled MCP client with official Go SDK Switch from custom JSON-RPC implementation to the official github.com/modelcontextprotocol/go-sdk. This removes all hand-rolled protocol types (jsonrpcRequest, jsonrpcResponse, RPCError, etc.) and uses the SDK's StreamableClientTransport with DisableStandaloneSSE for clean CLI process lifecycle. Also adds URL normalization/validation, config command, and updates init/README to reference YAML config. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
158 lines
3.7 KiB
Go
158 lines
3.7 KiB
Go
package cmd
|
|
|
|
import (
|
|
"browseros-cli/output"
|
|
|
|
"github.com/spf13/cobra"
|
|
)
|
|
|
|
func init() {
|
|
bookmarkCmd := &cobra.Command{
|
|
Use: "bookmark",
|
|
Annotations: map[string]string{"group": "Resources:"},
|
|
Short: "Manage bookmarks",
|
|
}
|
|
|
|
listCmd := &cobra.Command{
|
|
Use: "list",
|
|
Short: "List all bookmarks",
|
|
Args: cobra.NoArgs,
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
c := newClient()
|
|
result, err := c.CallTool("get_bookmarks", nil)
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Text(result)
|
|
}
|
|
},
|
|
}
|
|
|
|
createCmd := &cobra.Command{
|
|
Use: "create <title> [url]",
|
|
Short: "Create a bookmark or folder",
|
|
Args: cobra.RangeArgs(1, 2),
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
parent, _ := cmd.Flags().GetString("parent")
|
|
toolArgs := map[string]any{"title": args[0]}
|
|
if len(args) > 1 {
|
|
toolArgs["url"] = args[1]
|
|
}
|
|
if parent != "" {
|
|
toolArgs["parentId"] = parent
|
|
}
|
|
c := newClient()
|
|
result, err := c.CallTool("create_bookmark", toolArgs)
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Confirm(result.TextContent())
|
|
}
|
|
},
|
|
}
|
|
createCmd.Flags().String("parent", "", "Parent folder ID")
|
|
|
|
removeCmd := &cobra.Command{
|
|
Use: "remove <id>",
|
|
Short: "Remove a bookmark or folder",
|
|
Args: cobra.ExactArgs(1),
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
c := newClient()
|
|
result, err := c.CallTool("remove_bookmark", map[string]any{"id": args[0]})
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Confirm(result.TextContent())
|
|
}
|
|
},
|
|
}
|
|
|
|
updateCmd := &cobra.Command{
|
|
Use: "update <id>",
|
|
Short: "Update a bookmark",
|
|
Args: cobra.ExactArgs(1),
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
title, _ := cmd.Flags().GetString("title")
|
|
url, _ := cmd.Flags().GetString("url")
|
|
toolArgs := map[string]any{"id": args[0]}
|
|
if title != "" {
|
|
toolArgs["title"] = title
|
|
}
|
|
if url != "" {
|
|
toolArgs["url"] = url
|
|
}
|
|
c := newClient()
|
|
result, err := c.CallTool("update_bookmark", toolArgs)
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Confirm(result.TextContent())
|
|
}
|
|
},
|
|
}
|
|
updateCmd.Flags().String("title", "", "New title")
|
|
updateCmd.Flags().String("url", "", "New URL")
|
|
|
|
moveCmd := &cobra.Command{
|
|
Use: "move <id>",
|
|
Short: "Move a bookmark to a different folder",
|
|
Args: cobra.ExactArgs(1),
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
parent, _ := cmd.Flags().GetString("parent")
|
|
index, _ := cmd.Flags().GetInt("index")
|
|
toolArgs := map[string]any{"id": args[0]}
|
|
if parent != "" {
|
|
toolArgs["parentId"] = parent
|
|
}
|
|
if cmd.Flags().Changed("index") {
|
|
toolArgs["index"] = index
|
|
}
|
|
c := newClient()
|
|
result, err := c.CallTool("move_bookmark", toolArgs)
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Confirm(result.TextContent())
|
|
}
|
|
},
|
|
}
|
|
moveCmd.Flags().String("parent", "", "Target parent folder ID")
|
|
moveCmd.Flags().Int("index", 0, "Position index")
|
|
|
|
searchCmd := &cobra.Command{
|
|
Use: "search <query>",
|
|
Short: "Search bookmarks",
|
|
Args: cobra.ExactArgs(1),
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
c := newClient()
|
|
result, err := c.CallTool("search_bookmarks", map[string]any{"query": args[0]})
|
|
if err != nil {
|
|
output.Error(err.Error(), 1)
|
|
}
|
|
if jsonOut {
|
|
output.JSON(result)
|
|
} else {
|
|
output.Text(result)
|
|
}
|
|
},
|
|
}
|
|
|
|
bookmarkCmd.AddCommand(listCmd, createCmd, removeCmd, updateCmd, moveCmd, searchCmd)
|
|
rootCmd.AddCommand(bookmarkCmd)
|
|
}
|