respawn-llc/firefox-cli

AI 에이전트가 사용자의 Firefox 브라우저에 대한 터미널 기반 제어권을 제공합니다.

이는 agent-browser에서 영감을 받았지만, Firefox 사용자들을 위한 것입니다. 이 도구는 Firefox 확장 프로그램과 통신하여 에이전트가 실제 인증된 사용자의 세션을 통해 페이지를 검사하고, 탐색하며, 탭과 창을 조작하고, 요소와 상호 작용하며, 브라우저 상태를 읽고, 페이지 조건 대기, 스크린샷 캡처, 로그/네트워크 활동 관찰, 그리고 순차적인 브라우저 워크플로우를 CLI에서 실행할 수 있도록 합니다.

CLI 패키지 설치:

npm install -g firefox-cli

확장 프로그램 다운로드 URL 및 네이티브 호스트 설정 안내 출력:

firefox-cli setup

firefox-cli setup으로 표시된 URL에서 확장 프로그램을 설치합니다.
; Firefox에서 열고 설치 프롬프트를 수락합니다. 이 URL은 일치하는 CLI 버전에 대한 업데이트 매니페스트에서 선택됩니다.

네이티브 메시징 호스트 등록:

firefox-cli setup native-host

firefox-cli connect를 실행하고 Firefox에서 승인 요청에 응답합니다. 이 승인은 확장 프로그램을 로컬 네이티브 호스트와 페어링하고, 기기에서 CLI 요청을 활성화합니다.

설치 확인:

firefox-cli doctor

doctor는 네이티브 호스트 매니페스트 상태, 확장 프로그램 연결 상태, 승인 상태, 그리고 설정이 불완전할 때의 다음 조치를 보고합니다.

코딩 에이전트가 firefox-cli를 사용할 수 있는지, 그리고 어떻게 사용하는지 알도록 에이전트 스킬을 설치합니다.

skills CLI로 설치:

npx skills@latest add respawn-llc/firefox-cli

Respawn 마켓플레이스를 추가한 다음 플러그인을 설치합니다:

/plugin marketplace add respawn-llc/claude-plugin-marketplace
/plugin install firefox-cli@respawn-tools

공개 GitHub 경로에서 스킬을 설치합니다:

$skill-installer install https://github.com/respawn-llc/firefox-cli/tree/main/skills/firefox-cli

firefox-cli 확장 프로그램을 승인하면 페어링된 firefox-cli가...

사용자는 Firefox 브라우저 세션에 대한 완전한 제어권을 가지며, 여기에는 로그인된 사이트 사용 및 조작, 인증, 쿠키, 민감 데이터 처리 및 모든 활동 모니터링이 포함됩니다. firefox-cli를 실행할 수 있는 모든 행위자(actor)에 대해 책임을 질 것을 받아들이지 않는 한 페어링을 승인하지 마십시오.

Chrome/CDP / agent-browser 도구가 지원하는 모든 것이 Firefox에서 지원되는 것은 아닙니다:

• 비공개 창은 읽기가 가능하지만, 변경(mutating) 명령은 거부됩니다.
• 페이지 스냅샷과 요소 참조는 메인 프레임을 대상으로 하며, 크로스 오리진 iframe은 진단 목적으로만 사용됩니다.
• 스크린샷은 보이는 탭을 캡처하며 대상 탭이나 창을 활성화할 수 있습니다.
• 브라우저 내부 및 특권(privileged) Firefox 페이지는 확장 기능 스크립팅을 차단할 수 있습니다.

플랫폼 경로 및 문제 해결 방법은 docs/setup.md를, 명령어 구문은 docs/commands.md를 참조하십시오.

AGPL-3.0 전용. LICENSE를 참조하십시오.

Copyright (c) 2026 Respawn LLC