Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

refactor(cli): tabs → tab, nav hidden alias, update tests

Bosch534a87335f3f
diff --git a/cmd/pinchtab/cmd_cli.go b/cmd/pinchtab/cmd_cli.go
index d9fc240c..005fa01c 100644
--- a/cmd/pinchtab/cmd_cli.go
+++ b/cmd/pinchtab/cmd_cli.go
@@ -25,10 +25,10 @@ var quickCmd = &cobra.Command{
}
var navCmd = &cobra.Command{
- Use: "nav <url>",
- Short: "Navigate to URL (alias for open)",
- Deprecated: "use 'open' instead",
- Args: cobra.ExactArgs(1),
+ Use: "nav <url>",
+ Short: "Navigate to URL",
+ Hidden: true,
+ Args: cobra.ExactArgs(1),
Run: func(cmd *cobra.Command, args []string) {
cfg := config.Load()
runCLIWith(cfg, func(client *http.Client, base, token string) {
@@ -101,8 +101,9 @@ var openCmd = &cobra.Command{
}
var tabsCmd = &cobra.Command{
- Use: "tabs",
- Short: "List or manage tabs",
+ Use: "tab",
+ Aliases: []string{"tabs"},
+ Short: "List or manage tabs",
Run: func(cmd *cobra.Command, args []string) {
cfg := config.Load()
runCLIWith(cfg, func(client *http.Client, base, token string) {
diff --git a/cmd/pinchtab/root.go b/cmd/pinchtab/root.go
index ab306679..939cbad4 100644
--- a/cmd/pinchtab/root.go
+++ b/cmd/pinchtab/root.go
@@ -18,7 +18,7 @@ var rootCmd = &cobra.Command{
Long: `PinchTab provides a lightweight, API-driven way for AI agents to control
browsers, manage tabs, and perform interactive tasks.`,
Example: ` pinchtab server
- pinchtab nav https://pinchtab.com`,
+ pinchtab open https://pinchtab.com`,
Run: func(cmd *cobra.Command, args []string) {
cfg := config.Load()
diff --git a/tests/e2e/scenarios-cli/01-nav.sh b/tests/e2e/scenarios-cli/01-nav.sh
index 4c3e32cb..a2a8cc17 100755
--- a/tests/e2e/scenarios-cli/01-nav.sh
+++ b/tests/e2e/scenarios-cli/01-nav.sh
@@ -1,12 +1,12 @@
#!/bin/bash
-# 01-nav.sh — CLI navigation commands
+# 01-open.sh — CLI open commands
source "$(dirname "$0")/common.sh"
# ─────────────────────────────────────────────────────────────────
-start_test "pinchtab nav <url>"
+start_test "pinchtab open <url>"
-pt_ok nav "${FIXTURES_URL}/index.html"
+pt_ok open "${FIXTURES_URL}/index.html"
assert_output_json
assert_output_contains "tabId" "returns tab ID"
assert_output_contains "title" "returns page title"
@@ -14,21 +14,21 @@ assert_output_contains "title" "returns page title"
end_test
# ─────────────────────────────────────────────────────────────────
-start_test "pinchtab nav (invalid URL)"
+start_test "pinchtab open (invalid URL)"
-pt_fail nav "not-a-valid-url"
+pt_fail open "not-a-valid-url"
end_test
# ─────────────────────────────────────────────────────────────────
-start_test "pinchtab nav --tab <tabId> <url>"
+start_test "pinchtab open --tab <tabId> <url>"
# First navigate to get a tab
-pt_ok nav "${FIXTURES_URL}/index.html"
+pt_ok open "${FIXTURES_URL}/index.html"
TAB_ID=$(echo "$PT_OUT" | jq -r '.tabId')
# Navigate same tab using --tab flag
-pt_ok nav "${FIXTURES_URL}/form.html" --tab "$TAB_ID"
+pt_ok open "${FIXTURES_URL}/form.html" --tab "$TAB_ID"
assert_output_contains "form.html" "navigated to form.html"
end_test
diff --git a/tests/e2e/scenarios-cli/04-tabs.sh b/tests/e2e/scenarios-cli/04-tabs.sh
index ff3944ac..15b11320 100755
--- a/tests/e2e/scenarios-cli/04-tabs.sh
+++ b/tests/e2e/scenarios-cli/04-tabs.sh
@@ -9,7 +9,7 @@ start_test "pinchtab tabs (list)"
# Create a tab first
pt_ok nav "${FIXTURES_URL}/index.html"
-pt_ok tabs
+pt_ok tab
assert_output_json
assert_output_contains "tabs" "returns tabs array"
@@ -21,10 +21,10 @@ start_test "pinchtab tabs close <id>"
pt_ok nav "${FIXTURES_URL}/form.html"
TAB_ID=$(echo "$PT_OUT" | jq -r '.tabId')
-pt_ok tabs close "$TAB_ID"
+pt_ok tab close "$TAB_ID"
# Verify tab is gone
-pt_ok tabs
+pt_ok tab
assert_output_not_contains "$TAB_ID" "tab was closed"
end_test
diff --git a/tests/e2e/scenarios-cli/22-tabs-errors.sh b/tests/e2e/scenarios-cli/22-tabs-errors.sh
index c918a8eb..c19f9ee3 100755
--- a/tests/e2e/scenarios-cli/22-tabs-errors.sh
+++ b/tests/e2e/scenarios-cli/22-tabs-errors.sh
@@ -6,7 +6,7 @@ source "$(dirname "$0")/common.sh"
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab tabs returns valid JSON array"
-pt_ok tabs
+pt_ok tab
assert_output_json "tabs output is valid JSON"
assert_output_contains "tabs" "response contains tabs field"
@@ -20,10 +20,10 @@ pt_ok nav "${FIXTURES_URL}/index.html"
assert_output_json
TAB_ID=$(echo "$PT_OUT" | jq -r '.tabId')
-pt_ok tabs close "$TAB_ID"
+pt_ok tab close "$TAB_ID"
# Verify tab is gone
-pt_ok tabs
+pt_ok tab
assert_output_not_contains "$TAB_ID" "closed tab no longer in list"
end_test
@@ -31,13 +31,13 @@ end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab tabs close with no args → error"
-pt_fail tabs close
+pt_fail tab close
end_test
# ─────────────────────────────────────────────────────────────────
start_test "pinchtab tabs close nonexistent → error"
-pt_fail tabs close "nonexistent_tab_id_12345"
+pt_fail tab close "nonexistent_tab_id_12345"
end_test
diff --git a/tests/e2e/scenarios-cli/24-tab-eviction.sh b/tests/e2e/scenarios-cli/24-tab-eviction.sh
index 9a78b597..446e9883 100755
--- a/tests/e2e/scenarios-cli/24-tab-eviction.sh
+++ b/tests/e2e/scenarios-cli/24-tab-eviction.sh
@@ -16,7 +16,7 @@ for i in $(seq 1 $MAX_TABS); do
TAB_IDS+=($(echo "$PT_OUT" | jq -r '.tabId'))
done
-pt_ok tabs
+pt_ok tab
TAB_COUNT=$(echo "$PT_OUT" | jq '.tabs | length')
if [ "$TAB_COUNT" -ge "$MAX_TABS" ]; then
echo -e " ${GREEN}✓${NC} $TAB_COUNT tabs open (>= $MAX_TABS)"
@@ -35,7 +35,7 @@ FIRST_TAB="${TAB_IDS[0]}"
sleep 1
pt_ok nav "${FIXTURES_URL}/index.html?t=overflow"
-pt_ok tabs
+pt_ok tab
assert_output_not_contains "$FIRST_TAB" "oldest tab evicted (LRU)"
end_test
diff --git a/tests/e2e/scenarios-cli/35-open-close.sh b/tests/e2e/scenarios-cli/35-open-close.sh
index 5794fadf..683ef2ce 100755
--- a/tests/e2e/scenarios-cli/35-open-close.sh
+++ b/tests/e2e/scenarios-cli/35-open-close.sh
@@ -49,10 +49,10 @@ assert_output_contains "tabId" "navigate works as alias"
end_test
# ─────────────────────────────────────────────────────────────────
-start_test "pinchtab nav <url> (deprecated alias)"
+start_test "pinchtab nav <url> (hidden alias)"
pt_ok nav "${FIXTURES_URL}/index.html"
assert_output_json
-assert_output_contains "tabId" "nav still works as deprecated alias"
+assert_output_contains "tabId" "nav still works as hidden alias"
end_test