Files
BrowserOS/apps/cli/cmd/group.go
Nikhil b7e63a4a1f feat: add browseros-cli Go CLI for browser automation (#421)
* 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>
2026-03-05 14:49:45 -08:00

155 lines
3.7 KiB
Go

package cmd
import (
"fmt"
"browseros-cli/output"
"github.com/spf13/cobra"
)
func init() {
groupCmd := &cobra.Command{
Use: "group",
Annotations: map[string]string{"group": "Resources:"},
Short: "Manage tab groups",
}
listCmd := &cobra.Command{
Use: "list",
Short: "List all tab groups",
Args: cobra.NoArgs,
Run: func(cmd *cobra.Command, args []string) {
c := newClient()
result, err := c.CallTool("list_tab_groups", nil)
if err != nil {
output.Error(err.Error(), 1)
}
if jsonOut {
output.JSON(result)
} else {
output.Text(result)
}
},
}
createCmd := &cobra.Command{
Use: "create <pageId...>",
Short: "Group pages together",
Args: cobra.MinimumNArgs(1),
Run: func(cmd *cobra.Command, args []string) {
title, _ := cmd.Flags().GetString("title")
pageIDs := make([]int, 0, len(args))
for _, a := range args {
var id int
if _, err := fmt.Sscanf(a, "%d", &id); err != nil {
output.Errorf(3, "invalid page ID: %s", a)
}
pageIDs = append(pageIDs, id)
}
toolArgs := map[string]any{"pageIds": pageIDs}
if title != "" {
toolArgs["title"] = title
}
c := newClient()
result, err := c.CallTool("group_tabs", toolArgs)
if err != nil {
output.Error(err.Error(), 1)
}
if jsonOut {
output.JSON(result)
} else {
output.Confirm(result.TextContent())
}
},
}
createCmd.Flags().String("title", "", "Group title")
updateCmd := &cobra.Command{
Use: "update <groupId>",
Short: "Update tab group properties",
Args: cobra.ExactArgs(1),
Run: func(cmd *cobra.Command, args []string) {
title, _ := cmd.Flags().GetString("title")
color, _ := cmd.Flags().GetString("color")
collapsed, _ := cmd.Flags().GetBool("collapsed")
toolArgs := map[string]any{"groupId": args[0]}
if title != "" {
toolArgs["title"] = title
}
if color != "" {
toolArgs["color"] = color
}
if cmd.Flags().Changed("collapsed") {
toolArgs["collapsed"] = collapsed
}
c := newClient()
result, err := c.CallTool("update_tab_group", toolArgs)
if err != nil {
output.Error(err.Error(), 1)
}
if jsonOut {
output.JSON(result)
} else {
output.Confirm(result.TextContent())
}
},
}
updateCmd.Flags().String("title", "", "Group title")
updateCmd.Flags().String("color", "", "Group color (grey,blue,red,yellow,green,pink,purple,cyan,orange)")
updateCmd.Flags().Bool("collapsed", false, "Collapse the group")
ungroupCmd := &cobra.Command{
Use: "ungroup <pageId...>",
Short: "Remove pages from their groups",
Args: cobra.MinimumNArgs(1),
Run: func(cmd *cobra.Command, args []string) {
pageIDs := make([]int, 0, len(args))
for _, a := range args {
var id int
if _, err := fmt.Sscanf(a, "%d", &id); err != nil {
output.Errorf(3, "invalid page ID: %s", a)
}
pageIDs = append(pageIDs, id)
}
c := newClient()
result, err := c.CallTool("ungroup_tabs", map[string]any{"pageIds": pageIDs})
if err != nil {
output.Error(err.Error(), 1)
}
if jsonOut {
output.JSON(result)
} else {
output.Confirm(result.TextContent())
}
},
}
closeCmd := &cobra.Command{
Use: "close <groupId>",
Short: "Close a tab group and all its tabs",
Args: cobra.ExactArgs(1),
Run: func(cmd *cobra.Command, args []string) {
c := newClient()
result, err := c.CallTool("close_tab_group", map[string]any{"groupId": args[0]})
if err != nil {
output.Error(err.Error(), 1)
}
if jsonOut {
output.JSON(result)
} else {
output.Confirm(result.TextContent())
}
},
}
groupCmd.AddCommand(listCmd, createCmd, updateCmd, ungroupCmd, closeCmd)
rootCmd.AddCommand(groupCmd)
}