로컬 대시보드는 에이전트가 보는 방식 그대로 워크스페이스를 보여 주는 작은 웹 앱입니다. 제품, 각 제품에 대해 에이전트가 알고 있는 내용, 온보딩 진행 상황, 기록된 모든 제출 상태, 내 조치가 필요한 일, 후속 확인 날짜가 표시됩니다. 내 컴퓨터에서만 실행되고, 어떤 디렉터리에도 접속하지 않으며, 변경 기록에 있는 2026년 9월 15일 릴리스에서 추가됐습니다. 이 가이드는 대시보드를 시작하는 방법, 각 화면의 용도, 대시보드가 적용하는 규칙을 다룹니다.
시작하기
Windows에서는 아래 명령의 python3 대신 py -3를 사용하세요(Python 3.10 이상을 실행하는 명령이 python이라면 그것을 써도 됩니다). 워크스페이스는 OneDrive 같은 동기화 폴더가 아닌 비공개 로컬 폴더에 두세요.
python3 scripts/dashboard.py # opens 127.0.0.1:8765 in your browser
python3 scripts/dashboard.py --demo # explore a throwaway sample workspace
python3 scripts/dashboard.py --port 8790 --no-open
첫 번째 명령은 브라우저에서 127.0.0.1:8765를 열고, --demo는 일회용 샘플 워크스페이스를 띄웁니다. Python 3.10 이상의 표준 라이브러리만 사용하므로 의존성도, 빌드 단계도 없습니다. 비공개 워크스페이스, 즉 scripts/init-workspace.py가 만든 폴더에서 실행하세요. 공유 전달용 체크아웃에서 실행하면 워크스페이스를 만들겠느냐고 제안하는 것 말고는 아무것도 하지 않습니다. 가장 쉬운 방법은 여전히 세 단계 시작 가이드의 한 줄짜리 시작 프롬프트입니다. 에이전트가 워크스페이스를 만들고, 서버를 시작하고, 링크를 건네줍니다.
개요 화면
첫 화면은 무엇보다 먼저 “내가 처리할 일이 뭐지?“에 답합니다. 에이전트가 끝내지 못하고 넘긴 CAPTCHA와 2단계 인증, 차단됨으로 표시된 플랫폼, 기한이 지난 후속 확인, 끝나지 않은 온보딩이 여기에 나옵니다. 그 아래에는 상태 그룹(내 조치 필요, 문제, 검토 중, 예약됨, 게시됨)별 합계와 함께 제품 목록이 이어지고, workspace.json에서 읽은 워크스페이스 상태가 표시됩니다. 대시보드를 일주일에 한 번만 연다면 이 페이지만 보면 됩니다.
제품 페이지
각 제품에는 doctor.py가 만든 준비 상태 체크리스트, 마지막 세션 요약, 필터를 걸 수 있는 제출 목록, 온보딩 확인 항목, 제품 브리프, 신원 정보, 권한, 메모가 있습니다. “에이전트 보기”는 어떤 파일이 채워졌고 어떤 파일이 아직 비어 있는지 보여 줍니다. 세션이 일찍 끝났을 때 다음 세션에서 무엇을 묻게 될지 알고 싶다면 유용합니다. 여기에 표시되는 상태 용어는 트래커의 것이며, 각 상태의 의미는 등록 상태 용어집 항목에서 설명합니다.
실행 계획하고 재개하기
새로 확인된 제출 10건, 워커 최대 2개를 목표로 시작하세요. 실행 플래너는 로컬 하드웨어 정보를 바탕으로 병렬 한도를 권장합니다. 현재 부하도 함께 살펴보세요. 여유 용량을 알 수 없거나 컴퓨터가 바쁘다면 하나를 고르세요. 워커 두 개를 쓰려면 브라우저 작업 공간을 각각 따로 제어하고 플랫폼도 서로 다르게 배정해야 합니다. 하드웨어 권장값만으로는 이 조건이 갖춰졌다고 볼 수 없습니다.
실행을 저장한 다음 그 프롬프트를 에이전트에 복사하세요. 호스트가 지원하면 /goal을 쓰고, 그렇지 않으면 같은 텍스트를 일반 메시지로 붙여 넣으세요. 대시보드는 계획을 저장하고 남은 작업을 보여 주지만, 에이전트 워커를 띄우거나 브라우저 작업을 수행하지는 않습니다. 목표를 설정해도 제공업체의 한도나 사람이 직접 처리해야 하는 확인 절차를 건너뛸 수는 없습니다.
확인된 새 제출만 집계됩니다. 검토 대기, 대기열 등록, 예약, 게시 상태가 플랫폼당 한 번씩입니다. 초안과 기존 등록은 집계되지 않습니다. 이전 진행 상황을 잊어버리는 새 실행을 시작하지 말고, 저장된 실행을 재개하세요. 완료 기준, 사람에게 넘긴 작업, 창 정리는 실행 가이드에서 설명합니다.
결과 기록, 카탈로그, 프롬프트
Record outcome(결과 기록) 폼은 scripts/record.py를 거쳐 기록하며, 명령줄과 똑같은 규칙을 적용합니다. 상태는 정해진 값 중 하나여야 하고, 메모에는 링크나 비밀 정보를 넣을 수 없으며, live에는 공개 URL과 직접 확인했다는 진술이, scheduled에는 하한선 당일 또는 그 이후의 출시일이 필요하고, 이미 행이 있다면 명시적으로 교체해야 합니다. 각 규칙과 그 이유는 결과 기록 가이드에서 하나씩 설명합니다.
New product(새 제품)는 templates/project에서 빈 폴더를 만들고, 에이전트에게 줄 온보딩 프롬프트나 직접 채울 수 있는 폼 중 하나를 제공합니다. Catalog(카탈로그)에서는 모든 플랫폼을 검색하고 필터링하고, 어떤 플레이북이든 읽고, 특정 제품의 상태를 겹쳐 보고, 목록에서 바로 결과를 기록할 수 있습니다. Agent prompts and docs(에이전트 프롬프트 및 문서)는 에이전트 프롬프트를 복사 버튼과 함께 보여 주고 툴킷 문서를 그 자리에서 렌더링하므로, 마크다운 파일을 직접 열 일이 거의 없습니다.
절대 하지 않는 일
이 경계는 의도된 것이며, 대시보드에 의지하기 전에 알아 둘 가치가 있습니다.
127.0.0.1에만 바인딩되며 크로스 사이트 요청을 거부합니다.- 에이전트도 편집하는 제품 JSON 파일과 마크다운 파일만 편집합니다.
credentials.json은 플랫폼, 방식, 상태로만 표시되며, 값은 절대 브라우저로 전송되지 않습니다. - 아무것도 제출하지 않고, 브라우저를 제어하지 않으며, 등록 페이지를 검증하지도 않습니다. 상태를 기록하는 것은 증거가 아니라 운영자의 진술입니다. 대시보드는 그 진술을 쉽게, 그리고 잘못하기는 어렵게 만들어 줄 뿐 그 이상은 하지 않습니다.
대시보드가 제품, 에이전트, 디렉터리 사이에서 어디에 자리 잡는지는 작동 방식 페이지에 그림으로 나와 있습니다. 내 워크스페이스 없이 먼저 써 보고 싶다면 --demo로 시작하세요.