레퍼런스

Flag와 명령의 최종 계약은 live help입니다.

이 문서는 안정적인 command family를 요약합니다. 정확한 parser 표면은 agbrowse --help와 agbrowse web-ai --help 출력입니다.

Skill commands

skills, skills list, skills get, skills path, skills install. 번들된 agent skill(browser, web-ai, search, vision-click)을 조회하고 설치합니다. --target으로 skill root를 지정하고, --link로 글로벌 npm 패키지를 추적하며, --force로 기존 skill을 교체합니다.

Browser lifecycle

start, stop, status, reset. Chrome CDP 연결을 관리합니다. start는 --port, --headless, --chrome-path를 받습니다.

Observe

snapshot, screenshot, text, get-dom. DOM ref, 페이지 텍스트, 스크린샷, DOM fragment를 캡처합니다.

Act

click, type, press, hover, select, check, uncheck, drag, mouse-click, move-mouse, mouse-down, mouse-up. Ref 기반 또는 좌표 기반 페이지 mutation입니다.

Navigate

navigate, reload, resize, scroll, tabs, active-tab, tab-switch, select-tab, new-tab, tab-close, tab-cleanup. 네비게이션, 뷰포트, 탭 관리, active target 해석입니다.

Wait

wait, wait-for-selector, wait-for-text, wait-for. 시간, selector, text, legacy ref 대기입니다.

Diagnostics

console, network, evaluate. Console/network 로그 캡처 또는 페이지 JavaScript 실행입니다.

URL read

fetch <url> — 단일 URL을 읽는 6단계 adaptive escalation ladder. 주요 플래그: --json, --trace, --browser auto|never|required, --browser-session none|isolated|existing|user|interactive, --identity auto|minimal|chrome, --allow-third-party-reader, --max-bytes N, --timeout-ms N, --selector CSS.

Search commands

search "<query>" — standalone deep search: query rewrite, adaptive-fetch ladder(TLS-impersonation, Camoufox, feed-parser, BM25, table-extractor, candidate-discovery)를 통한 후보 발견과 증거 채점. 플래그: --json, --deep, --verify <url>, --stdin-results, --browser auto|never, --max-results N, --vendor grok|chatgpt|gemini.

Research commands

research plan, research normalize-results, research enrich-fetch, research browse-plan. 한국어/출처 민감 검색을 위한 offline planning surface: 쿼리를 제약 조건과 후보 URL로 분해, provider 검색 결과 정규화, adaptive fetch로 URL 보강, 브라우저 에스컬레이션 계획. 이 명령들은 live search를 실행하거나 browser state를 변경하지 않습니다.

Runway commands

runway selectors, runway status, runway open, runway preflight, runway poll. Runway Apps/Custom media task-runner용 read-only preflight. 안전 계약: generate, submit, payment 컨트롤은 클릭하지 않습니다.

Web-AI commands

render, status, send, poll, query, code, code-extract, stop, watch, snapshot, observe-bundle, observe-actions, upload, sessions list|show|resume|reattach|doctor|prune, project-sources list|add, context-dry-run, context-render, doctor, claim-audit, eval, mcp-server, work send.

ChatGPT Deep Research

--research deep는 ChatGPT Deep Research 모드를 활성화합니다(experimental). 리포트 artifact를 저장하고, 세션에 researchMode: "deep"를 기록하며, auto archive를 건너뛰고, 제출 후 plan card를 자동 확인합니다. ChatGPT 전용이며 --follow-up과 함께 사용할 수 없습니다.

ChatGPT 이미지 출력

--output-image ./out.png로 ChatGPT 생성 이미지를 저장합니다. 여러 이미지는 형제 파일로 저장됩니다(out.png, out-2.png, out-3.png). Fail-closed: 이미지를 감지하거나 저장할 수 없으면 provider.image-output을 반환합니다.

ChatGPT follow-ups

--follow-up "..."는 같은 명령에서 순차적 후속 프롬프트를 추가합니다. ChatGPT 전용이며 --research deep와 함께 사용할 수 없습니다.

Help checks

agbrowse --help
agbrowse web-ai --help
agbrowse web-ai code --help
agbrowse web-ai code-extract --help
agbrowse web-ai work --help
agbrowse runway --help
agbrowse search --help
agbrowse research --help
agbrowse skills --help

ChatGPT Work

agbrowse web-ai work send --prompt "Analyze this repository" --power 4

--power는 1부터 6까지 받습니다. MCP에서는 web_ai_work_send를 씁니다. Chat 명령과 web_ai_submit_prompt는 Work에서 중단하며 surface=work를 받지 않습니다.

ChatGPT 모델 입력

예전 effort는 light|low|standard|normal|regular|default → medium, extended → high, heavy|extra-high|extra_high|extra high → xhigh로 바꿉니다. extended는 High 선택 뒤 stderr 경고 1줄을 냅니다. 예전 Pro effort 입력은 단일 Pro 행으로 처리하고 같은 형식의 선택 없음 경고 1줄을 냅니다.

timeout 적용 순서

직접 지정한 timeout, 저장된 deadline의 남은 시간, tier 기본값, vendor fallback 순서입니다. tier를 알 수 없으면 ChatGPT 1200초, Gemini 1200초, Grok 600초를 씁니다.

사용자가 알려 준 ChatGPT Pro 약 40분은 이번 DOM에서 확인되지 않은 UI 쪽 예산입니다. agbrowse timeout과는 별개입니다.