TabbitBlog

Agweb Browser란? 기능, 지원 환경과 제한

paul-nameless/agweb의 WebKit 창, 포커스 동작, CLI, macOS 요구 사항과 Playwright가 필요한 경우를 설명합니다.

이 글의 목차
  1. 핵심 요약
  2. Agweb 한눈에 보기
  3. 에이전트가 일하는 동안 창은 계속 보입니다
  4. 어떤 작업에 맞고 맞지 않나요?
  5. Mac과 도구가 맞을 때만 설치하세요
  6. 제약도 도구 선택의 일부입니다
  7. 브라우저 자체를 작업 공간으로 쓰는 다른 방법
  8. 결론

브라우저 자동화 창이 편집기 앞으로 튀어나온다면 paul-nameless/agweb을 살펴볼 만합니다. README에 따르면 Agweb은 에이전트가 셸에서 제어하는 macOS 브라우저로, 에이전트가 작동해도 창을 전면으로 가져오지 않도록 설계되었습니다. Show HN에서 자신의 웹 앱을 테스트하는 한 사용자는 테스트 중 포커스를 빼앗기는 일이 “정말 골칫거리”가 되었다고 말했습니다. 이 말은 해결하려는 문제를 보여줍니다. Agweb이 실제로 이를 해결한다는 내용은 관리자의 설명이며, 이 글에서 측정한 결과는 아닙니다. Show HN 댓글

먼저 이름을 구분해야 합니다. 이 글은 github.com/paul-nameless/agweb의 오픈 소스 프로젝트를 다룹니다. 농업 뉴스와 시장 정보를 제공하는 AgWeb.com도, 일반 브라우저 자동화 프레임워크도 아닙니다. macOS 앱과 명령줄 제어 기능을 결합한 특정 브라우저입니다.

Agweb 대시보드에서 여섯 개 에이전트 브라우저 탭과 작업 공간 목록을 확인하는 화면
Agweb 프로젝트 README에 실린 대시보드 화면.

핵심 요약

  • Agweb은 WebKit 기반의 화면 표시형 브라우저입니다. 관리자는 에이전트 동작이 창을 전면으로 가져오지 않는다고 설명합니다.

  • 2026년 11월 16일에 GitHub에서 확인한 최신 릴리스는 v0.3.0입니다. macOS 26 이상이 필요하며 관리자는 macOS 26에서만 테스트했다고 말합니다.

  • 에이전트별 작업 공간으로 탭을 나눌 수 있지만 같은 이름의 프로필을 쓰는 에이전트는 로그인 상태를 공유합니다.

  • CDP를 제공하지 않습니다. Playwright와 Chrome 확장 프로그램을 연결할 수 없고, 일부 Chrome 전용 사이트는 정상 동작하지 않을 수 있습니다.

  • Mac에서 에이전트 탭을 보면서 다른 창에서 일하려는 로컬 작업에는 맞을 수 있습니다. Chrome 호환성, CDP, 확장, 헤드리스 또는 서버 실행이 필요하면 다른 도구를 선택하세요.

Agweb 한눈에 보기

질문프로젝트 문서의 설명실무상 의미
무엇인가요?agweb 셸 명령으로 제어하는 WebKit 기반 macOS 브라우저입니다.앱과 CLI는 하나의 로컬 흐름이며 호스팅 브라우저 API는 아닙니다.
“백그라운드”는 무슨 뜻인가요?창은 보이며, 관리자는 포커스를 빼앗지 않는다고 설명합니다. Cmd+D로 에이전트 탭 대시보드를 엽니다.다른 앱에서 계속 일할 수 있지만 브라우저 창은 보이고 로컬 자원을 씁니다.
에이전트 세션은 어떻게 나뉘나요?에이전트마다 작업 공간과 탭이 있고 이름 있는 프로필은 공유할 수 있습니다.작업 공간은 탭을 정리하며, 쿠키와 로그인은 프로필 단위로 공유됩니다.
가장 큰 호환성 제약은?WebKit만 사용하고 Chrome DevTools Protocol은 없습니다.Playwright와 Chrome 확장을 연결할 수 없으므로 실제 사이트를 확인해야 합니다.
시스템 요구 사항은?macOS 26 이상입니다.릴리스 페이지에 Windows와 Linux 패키지는 없습니다.

에이전트가 일하는 동안 창은 계속 보입니다

Agweb은 실제 브라우저 창입니다. README는 에이전트가 동작해도 창이 앞으로 나오지 않으며 Cmd+D를 누르면 각 작업 공간의 탭을 볼 수 있다고 안내합니다. 여기서 백그라운드는 에디터나 다른 앱을 계속 쓸 수 있다는 뜻입니다. 숨겨진 헤드리스 프로세스라는 뜻은 아닙니다.

셸 명령으로 페이지를 열고 스냅샷을 가져옵니다. README의 예시는 다음과 같습니다.

agweb -w task open en.wikipedia.org/wiki/WebKit
agweb -w task snapshot

첫 줄은 task 작업 공간에서 페이지를 열고, 둘째 줄은 요소 참조가 포함된 페이지 트리를 읽습니다. README는 동작 후 변경 사항을 반환한다고 설명합니다. v0.3.0은 다른 요소에 가려진 대상을 클릭할 때도 개선되었습니다. 기본적으로 클릭이 실패하고 가린 요소를 알려 주며, 호출자가 --force를 지정해야 강제로 클릭합니다. 전체 명령은 현재 agweb help를 확인하세요. 공식 README · v0.3.0 릴리스 노트

창이 보인다고 해서 에이전트가 올바른 계정으로 작업했는지, 올바른 항목을 골랐는지, 변경을 완료했는지 알 수 있는 것은 아닙니다. 페이지의 결과를 읽고 요약을 판단하세요. 연결 방식에 대해서는 브라우저 MCP와 CLI 비교를 참고할 수 있습니다.

어떤 작업에 맞고 맞지 않나요?

로컬 코딩 에이전트가 화면에 보이는 브라우저를 써야 하고 Mac에서 다른 작업도 계속하고 싶다면 Agweb을 검토할 수 있습니다. Chrome 내부 인터페이스가 필요하거나 원격 Linux 서버에서 실행해야 한다면 잘 맞지 않습니다.

조건Agweb 적합성다음 단계
macOS 26 이상에서 여러 에이전트 탭을 보면서 창을 전환하고 싶지 않습니다.README가 설명하는 사용 사례에 가깝습니다.민감하지 않은 사이트로 먼저 시도하세요.
테스트에 CDP나 Chrome 확장 프로그램이 필요합니다.부적합합니다. README에 따르면 둘 다 연결할 수 없습니다.CDP 호환 Chrome 환경을 유지하세요. Show HN에서도 CDP가 없으면 자신의 흐름에는 쓸 수 없다는 의견이 나왔습니다. 댓글
대상 사이트가 Chrome에서만 제대로 작동합니다.불확실합니다. 프로젝트는 일부 사이트가 다르게 동작할 수 있다고 경고합니다.실제 사이트와 절차를 시험하거나 Chrome을 사용하세요.
헤드리스 브라우저, 클라우드 Worker 또는 Linux 컨테이너가 필요합니다.문서에 지원 내용이 없습니다. Agweb은 화면 표시형 macOS 앱으로 소개됩니다.해당 환경을 위해 설계된 브라우저 서비스나 자동화 스택을 사용하세요.
에이전트마다 다른 로그인 신원이 필요합니다.작업 공간만 나누면 충분하지 않습니다. 같은 프로필은 로그인 상태를 공유합니다.로그인 전에 프로필을 분리하고 공유 범위를 확인하세요.

따라서 “에이전트별 작업 공간”이 “에이전트별 브라우저 신원 격리”를 뜻하지는 않습니다. HN 참여자는 사람이 방해받지 않는 “병렬 섀도” 환경을 원한다고 적었습니다. 이는 확인할 만한 요구 사항이지만 Agweb이 쿠키나 네트워크 신원을 격리한다는 증거는 아닙니다. README는 같은 이름의 프로필을 사용하는 에이전트가 로그인 상태를 공유한다고 설명합니다. HN 댓글

Mac과 도구가 맞을 때만 설치하세요

v0.3.0 릴리스는 macOS 26 이상을 요구하며 Windows나 Linux 패키지는 안내하지 않습니다. 관리자는 macOS 26만 테스트했다고 밝혔습니다. 구형 macOS에서 앱이 실행된다고 해서 호환성이 보장되는 것은 아닙니다.

문서에 나온 절차는 GitHub Releases에서 DMG를 내려받아 Agweb을 Applications로 옮긴 뒤 실행하는 것입니다. 앱에서 Help → Install Command Line Tool, Help → Install Agent Skill을 선택합니다. README에 따르면 Skill은 Claude Code와 Codex용입니다. 소스 빌드는 선택 사항이며 Xcode 26 이상이 필요합니다. 작동 방식을 알아보려는 것뿐이라면 먼저 설치할 필요는 없습니다. 릴리스 설치 방법

업무 계정에 로그인하기 전 에이전트가 사용할 프로필을 정하세요. README에 따르면 이름 있는 프로필은 로그인 상태를 유지하며 그 프로필을 사용하는 여러 에이전트가 동시에 공유합니다. 작업 공간은 탭을 나누지만 쿠키를 격리하지는 않습니다. HN에서는 기본 브라우징 세션의 쿠키를 쓰면서 동시에 사용자를 방해하지 않길 바라는 의견이 나왔습니다. 이를 선호 사항으로 보고 팀의 계정 정책과 함께 판단하세요. HN 토론 · 프로필, 작업 공간, 탭 그룹

첫 실행은 공개 페이지에서 범위를 좁혀 진행하세요. URL, 제목, 지정한 부분을 읽고 확인할 수 없는 내용은 표시하라고 요청합니다. 페이지가 바뀌면 새 스냅샷을 읽은 뒤 조작하세요. 첫 브라우저 에이전트 체크리스트와 agent-browser CLI 튜토리얼도 참고할 수 있습니다.

제약도 도구 선택의 일부입니다

가장 큰 기술적 경계는 WebKit입니다. README에 따르면 CDP가 없으므로 Playwright와 Chrome 확장 프로그램은 연결할 수 없습니다. Show HN 참여자는 이 점 때문에 자신의 용도에는 쓸모가 없다고 말했습니다. 관리자의 답도 분명합니다. Agweb은 WebKit을 사용하므로 CDP가 필요하면 Playwright를 쓰라는 것입니다. Show HN 토론

README는 Chrome 전용 사이트 중 일부가 다르게 동작할 수 있다고 경고합니다. 네트워크 도구도 제한적입니다. route는 fetch와 XHR만 모킹하고, requests는 리소스 URL만 나열합니다. 광고 차단 목록을 내려받아 쓰지만 uBlock 스크립트는 실행하지 않으므로 광고 차단을 끄라는 화면이 나타날 수 있습니다. 실제 결제나 엄격한 브라우저 검사를 에이전트가 처리해야 한다면 해당 사이트에서 직접 확인하세요. 일반 페이지가 열린다는 것만으로 사이트 전체의 호환성이 입증되지는 않습니다.

README에는 비활성 페이지 5개를 대상으로 한 메모리 비교가 있습니다. 이는 관리자가 보고한 수치이며 이 글의 독립 벤치마크가 아닙니다. 사용량은 페이지, 하드웨어, 작업에 따라 달라집니다. 이 글에서는 Agweb을 설치하거나 호환성, 포커스 동작, 자원 사용량을 시험하지 않았습니다.

브라우저 자체를 작업 공간으로 쓰는 다른 방법

Agweb은 에이전트에 전용 화면 표시형 브라우저를 제공하려는 개발자에게 맞습니다. 조사, 로그인, 수동 검토에 쓰는 브라우저를 지원되는 로컬 코딩 에이전트가 조작하길 원하는 경우도 있습니다. Tabbit Browser에는 지원 클라이언트용 작업 탭과 브라우저 컨텍스트를 제공하는 별도의 CLI 흐름이 있습니다. Agweb과 다른 방식이며 WebKit, CDP, 같은 포커스 동작을 뜻하지 않습니다. Tabbit CLI 안내와 Codex 설정 가이드에서 지원 여부를 확인하세요.

에이전트가 작업하는 동안 사람이 계속 일하는 방법을 비교한다면 백그라운드 브라우저 자동화와 브라우저 자동화 에이전트 가이드를 보세요. AI 에이전트가 브라우저를 제어하게 하는 방법과 에이전트를 기존 브라우저에 연결하기는 더 넓은 범주의 설정을 다룹니다. 이 글은 Agweb의 구체적인 장단점을 설명합니다.

결론

Agweb은 브라우저 창이 에이전트를 실행하는 사람을 방해한다는 문제에 답하려고 합니다. 화면에 보이는 대시보드, 셸 명령, 에이전트별 작업 공간은 Mac 로컬 작업을 겨냥합니다. 제한도 분명합니다. macOS 26 이상, WebKit, CDP 미지원, 일부 Chrome 사이트의 호환성 불확실성, 이름 있는 프로필 안에서 공유되는 로그인 상태입니다.

설치 전 릴리스 페이지에서 운영체제와 CDP 요구 사항을 확인하세요. 맞는다면 공개 페이지부터 시작해 스냅샷과 실제 결과를 확인한 후 로그인된 프로필을 사용할지 결정하면 됩니다. 브라우저 제어 방식을 더 비교하려면 AI 에이전트 브라우저 제어 안내를 참고하세요.

자주 묻는 질문

Agweb은 AgWeb.com과 같은 사이트인가요?

아닙니다. AgWeb.com은 농업 뉴스와 원자재 시장 사이트입니다. 이 글의 Agweb은 macOS 코딩 에이전트용 오픈 소스 브라우저인 paul-nameless/agweb을 가리킵니다.

Agweb에는 어떤 macOS 버전이 필요한가요?

v0.3.0 릴리스는 macOS 26 이상을 요구하며, 관리자는 macOS 26에서만 테스트했다고 밝혔습니다. 릴리스 페이지에는 Windows나 Linux 빌드가 안내되어 있지 않습니다.

Agweb은 헤드리스로 백그라운드에서 실행되나요?

문서는 대시보드가 있는 화면 표시형 데스크톱 창을 설명합니다. 포커스를 뺏지 않는다는 말은 에이전트가 작업해도 창이 앞으로 나오지 않도록 설계되었다는 뜻이며, 문서화된 헤드리스 브라우저 서비스라는 의미는 아닙니다.

Playwright를 Agweb에 연결할 수 있나요?

아니요. Agweb은 WebKit을 사용하고 README에 따르면 Chrome DevTools Protocol을 제공하지 않으므로 Playwright와 Chrome 확장 프로그램을 연결할 수 없습니다. 이 인터페이스가 필요하면 CDP 호환 브라우저를 사용하세요.

에이전트 작업 공간은 서로 격리되나요?

작업 공간은 에이전트별 탭을 정리하지만 같은 이름의 프로필을 사용하는 에이전트는 로그인 상태를 공유합니다. 작업 공간이 별도의 쿠키 저장소나 사용자 신원을 뜻하지는 않습니다.

Agweb은 어떻게 설치하나요?

공식 GitHub Releases에서 DMG를 내려받아 Agweb을 Applications로 옮긴 뒤 실행합니다. 이후 Help 메뉴에서 명령줄 도구와 에이전트 Skill을 설치합니다. 소스 빌드는 별도 경로이며 Xcode 26 이상이 필요합니다.

다음 단계

Tabbit 과 함께 일하세요.

탭 간 조사를 하고, 반복적인 브라우저 작업을 자동화하며, 모든 맥락을 손이 닿는 곳에 두세요.