@agentrhq/webcmd 0.2.5 → 0.3.1

package/skills/webcmd-usage/SKILL.md

@@ -44,21 +44,25 @@ npx tsx src/main.ts <command>
 
 Electron desktop app adapters route through CDP against the running app. Make sure the app is open before invoking those commands.
 
-## Discover Installed Commands
+## Discover Commands
 
 Run commands instead of reading static docs:
 
 ```bash
-webcmd list
+webcmd
 webcmd list -f json
-webcmd list | grep -i github
 webcmd <site> --help
 webcmd <site> <command> --help
 ```
 
-Do not hard-code adapter lists. `webcmd list -f json` is the source of truth and emits one entry per command with fields such as `{site, name, aliases, description, strategy, browser, args, columns}`.
+Run `webcmd` with no arguments to see all available functions and installed site adapters. Do not hard-code adapter lists: `webcmd list -f json` is the source of truth for installed commands and emits one entry per command with fields such as `{site, name, aliases, description, strategy, browser, args, columns}`.
 
-Before falling back to raw `webcmd browser` on high-change authenticated sites, check whether a site adapter already exposes the workflow.
+Use this fallback order:
+
+1. Run `webcmd list -f json` once.
+2. Check that result against the whole requested workflow, not only a named site. If one installed command covers it, use that command and stop discovery.
+3. If none covers it, derive a short plugin query from the missing site or capability and run `webcmd plugin search <query> -f json`. Preserve the user's term when practical: `find flights` becomes `flight`.
+4. If plugin search returns a match, offer `webcmd plugin install <installSource>`. If it returns no match and no error, raw `webcmd browser` is allowed. If it errors, report plugin discovery as unavailable and stop. If `fetch failed` appears in `errors[].message`, report plugin discovery as unavailable due to network/reachability and ask the user whether to rerun with network/escalated permissions. Do not retry unless they approve.
 
 ## Universal Flags
 
@@ -100,6 +104,13 @@ webcmd <site> <command> [args...] --trace retain-on-failure
 
 The error envelope includes a `trace` block pointing at `summary.md`. Patch only `adapterSourcePath` from that summary and retry. Maximum 3 repair rounds. See `webcmd-autofix`.
 
+## Report A Webcmd Defect
+
+After a reproducible Webcmd failure has been diagnosed or the `webcmd-autofix`
+retry budget is exhausted, load `webcmd-autofix` and follow its Step 6 reporting
+flow. Do not report expected authentication, configuration, CAPTCHA, rate-limit,
+argument, transient, or unreproduced failures.
+
 ## Writing An Adapter
 
 Storage paths:
@@ -129,10 +140,13 @@ webcmd plugin list [-f json]
 webcmd plugin update [name] | --all
 webcmd plugin uninstall <name>
 webcmd plugin create <name>
-webcmd plugin search [query]
+webcmd plugin search [query] -f json
+webcmd plugin catalog list -f json
+webcmd plugin catalog add <source>
+webcmd plugin catalog remove <id>
 ```
 
-Plugins are installable extensions pulled from git or local paths. Main-repo community CLIs are exposed through the root plugin catalog manifest, not bundled into npm's `clis/` set.
+Plugins are installable extensions pulled from git or local paths. Use `plugin search` for marketplace discovery and `plugin list` for already-installed plugins. Main-repo community CLIs are exposed through the root plugin catalog manifest, not bundled into npm's `clis/` set.
 
 > **Note:** The repository's `plugins/` directory is not shipped in the npm package. Find the required plugin with `webcmd plugin search`, then install its `installSource` with `webcmd plugin install <installSource>`.
 

package/clis/antigravity/SKILL.md

@@ -1,38 +0,0 @@
----
-description: How to automate Antigravity using Webcmd
----
-
-# Antigravity Automation Skill
-
-This skill allows AI agents to control the [Antigravity](https://github.com/chengazhen/Antigravity) desktop app (and any Electron app with CDP enabled) programmatically via Webcmd.
-
-## Requirements
-webcmd automatically detects, launches (with `--remote-debugging-port=9234`), and connects to Antigravity.
-If Antigravity is already running without CDP, webcmd will prompt to restart it.
-
-If the endpoint exposes multiple inspectable targets, set:
-\`\`\`bash
-export WEBCMD_CDP_TARGET="antigravity"
-\`\`\`
-
-## High-Level Capabilities
-1. **Send Messages (`webcmd antigravity send <message>`)**: Type and send a message directly into the chat UI.
-2. **Read History (`webcmd antigravity read`)**: Scrape the raw chat transcript from the main UI container.
-3. **Extract Code (`webcmd antigravity extract-code`)**: Automatically isolate and extract source code text blocks from the AI's recent answers.
-4. **Switch Models (`webcmd antigravity model <name>`)**: Instantly toggle the active LLM (e.g., \`gemini\`, \`claude\`).
-5. **Clear Context (`webcmd antigravity new`)**: Start a fresh conversation.
-
-## Examples for Automated Workflows
-
-### Generating and Saving Code
-\`\`\`bash
-webcmd antigravity send "Write a python script to fetch HN top stories"
-# wait ~10-15 seconds for output to render
-webcmd antigravity extract-code > hn_fetcher.py
-\`\`\`
-
-### Reading Real-time Logs
-Agents can run long-running streaming watch instances:
-\`\`\`bash
-webcmd antigravity watch
-\`\`\`