garrytan/gstack · error · Error

Usage: download <url|@ref> [path] [--base64] [--navigate]

Error message

Usage: download <url|@ref> [path] [--base64] [--navigate]

What it means

Error "Usage: download <url|@ref> [path] [--base64] [--navigate]" thrown in garrytan/gstack.

Source

Thrown at browse/src/write-commands.ts:1146

      // Guard against Anthropic vision API >2000px brick (#1214). Only
      // applies to fullPage captures; scrollTo viewport-bound shots are
      // already capped by the viewport size.
      if (!scrollTo) await guardScreenshotPath(outputPath);

      // Restore viewport
      if (viewportWidth && originalViewport) {
        await page.setViewportSize(originalViewport);
      }

      const parts = ['Screenshot saved'];
      if (doCleanup) parts.push('(cleaned)');
      if (scrollTo) parts.push(`(scrolled to: ${scrollTo})`);
      parts.push(`: ${outputPath}`);
      return parts.join(' ');
    }

    case 'download': {
      if (args.length === 0) throw new Error('Usage: download <url|@ref> [path] [--base64] [--navigate]');
      const isBase64 = args.includes('--base64');
      const useNavigate = args.includes('--navigate');
      const filteredArgs = args.filter(a => a !== '--base64' && a !== '--navigate');
      let url = filteredArgs[0];
      const outputPath = filteredArgs[1];

      // Resolve @ref to element src
      if (url.startsWith('@')) {
        const resolved = await bm.resolveRef(url);
        if (!('locator' in resolved)) throw new Error(`Expected @ref, got CSS selector: ${url}`);
        const locator = resolved.locator;
        const tagName = await locator.evaluate(el => el.tagName.toLowerCase());
        if (tagName === 'img') {
          url = await locator.evaluate(el => {
            const img = el as HTMLImageElement;
            return img.currentSrc || img.src || img.getAttribute('data-src') || '';
          });
        } else if (tagName === 'video') {

View on GitHub (pinned to 94993f7401)

When it happens

Trigger: Thrown at browse/src/write-commands.ts:1146 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of garrytan/gstack@94993f7401 (2026-08-12). Data as JSON: /api/errors/76ab7c43ba57d940. Report an issue: GitHub.