핵심 기능

에이전트 구성 전체를 한눈에

Berth는 AI agent 뒤의 plain-text files와 local databases를 구조화된 탐색 가능한 객체로 바꿉니다. 이 페이지는 app views, scan engine, adapter model을 함께 설명합니다.

Overview

모든 것의 대시보드

자산 수, 최근 세션, 이번 주 지출, 헬스 체크를 한 화면에.

  • 자산 인벤토리
  • 최근 활동
  • 비용과 헬스 체크
Sessions

지난 작업 탐색

프로젝트나 날짜로 세션을 따라가며 로드된 Skill, 연결된 MCP, 발생한 Hook, 산출물을 확인.

  • 프로젝트/날짜로 그룹화
  • 세션별 로드 자산
  • 도구 타임라인
Configuration

장비 점검

Instructions와 Capabilities를 두 열로 표시하고, user / project / enterprise 스코프를 병합하며 source path, scope, conflict를 함께 표시합니다.

  • Instructions와 Capabilities
  • 스코프 병합
  • 충돌 감지
Usage

지출과 토큰

모델·프로젝트·일자별 비용과 토큰 추이를 봅니다. Berth는 provider 청구서처럼 보이게 하지 않고 로컬 추정값임을 분명히 표시합니다.

  • 모델/프로젝트/일자별
  • 토큰 분해
  • 로컬 추정값
Scan Engine

인덱서 자체 보기

Settings는 scan engine version, status, indexed asset count, indexed file count, errors, scheduler state, editable watcher timing을 표시합니다.

  • Engine version
  • Indexed files
  • Editable controls
Scan engine

숨은 백그라운드 작업이 아니라 보이는 인덱서

Berth의 데이터 계층은 독립 패키지인 @berth/scan-engine입니다. 데스크톱 앱은 worker-backed runtime으로 이를 사용하고, 패키지는 독립적으로 유지되는 통합을 위해 CLI와 adapter API도 제공합니다.

Package
@berth/scan-engine

Scanner, adapter registry, shared asset model, CLI는 Electron UI 밖의 package boundary 안에 있습니다.

Adapter API
./adapter-api

Adapter definition에는 source policy, permissions, evidence URLs, sensitivity, version probing이 포함됩니다.

Cache mode
SQLite SWR

앱은 마지막 로컬 인덱스를 빠르게 복원하고 백그라운드에서 새로 고칩니다.

Worker mode
one-shot

무거운 스캔은 renderer 밖에서 실행되며 project-scope refresh와 file-change update를 큐에 넣습니다.

Settings가 보여주는 항목

Manual refresh

Scanner를 즉시 실행하고 runtime status가 scanning에서 ready로 돌아오는 과정을 볼 수 있습니다.

Watcher debounce

파일 변경 후 refresh를 예약하기 전에 Berth가 기다리는 시간을 조정합니다.

Minimum refresh interval

시끄러운 file watcher가 같은 프로젝트를 반복해서 다시 인덱싱하지 않도록 합니다.

Scheduler state

예약 및 큐에 들어간 refresh reason을 표시합니다. Pause와 cancel은 사용할 수 없을 때 unsupported로 정확히 표시합니다.

Adapter coverage

독립 에이전트 어댑터, 하나의 asset model

각 adapter는 scan root와 source policy를 직접 소유합니다. AGENTS.md 같은 공유 compatibility file은 source coverage로 계산할 수 있지만, agent가 설치되었다고 잘못 표시하지 않습니다.

Claude Code

core

Claude 전용 root에서 instructions, skills, subagents, MCP servers, hooks, sessions, usage metadata를 읽습니다.

Codex

core

Codex home과 project에서 Codex config, AGENTS.md, hooks, skills, sessions, rollout metadata를 읽습니다.

Gemini CLI

adapter v1

User 및 project root에서 settings, GEMINI.md context files, extensions, session metadata를 읽습니다.

GitHub Copilot CLI

adapter v1

Copilot instructions, agents, skills, hooks, MCP/LSP config, plugins, metadata-only session sources를 읽습니다.

Cursor

adapter v1

Project 및 config root에서 rules, MCP config, hooks, permissions, skills, agents, plugins를 읽습니다.

OpenCode

adapter v1

opencode config, agents, commands, skills, plugins, auth presence, logs, session database metadata를 읽습니다.

OpenClaw

adapter v1

workspace guidance, skills, extensions, plugins, session indexes, credentials presence, debug summaries를 읽습니다.

Hermes Agent

adapter v1

config, profiles, identity files, memories, skills, plugins, hooks, project context files를 읽습니다.

Safety model

읽을 수 있다고 해서 쓸 수 있는 것은 아닙니다

  • Berth는 알려진 로컬 root를 스캔하고 각 asset의 source path를 표시해 출처를 확인할 수 있게 합니다.
  • Credentials와 tokens는 presence 또는 metadata로만 다루며 secret value는 표시하지 않습니다.
  • Local SQLite index와 scan settings는 이 기기에 남고 Berth에서만 사용됩니다.
  • Telemetry, account, cloud sync가 없습니다. External link는 GitHub releases 또는 인용한 documentation으로 갑니다.
지식베이스로 이동