시작하기
이 가이드는 Maekon을 처음 실행하고, 로컬 대시보드를 확인한 뒤, 선택적 조직 연결이 필요한지 판단하는 과정을 안내합니다.
1. Maekon 실행
설치 후 응용 프로그램 폴더(macOS), 시작 메뉴(Windows), 또는 maekon 명령어(Linux)로 실행하세요. 앱은 시스템 트레이에 최소화된 상태로 시작됩니다 — 트레이 아이콘을 클릭하면 메인 윈도우가 열립니다.
2. 먼저 독립 실행
Maekon은 ONESHIM 없이도 독립 사용 가능합니다. 먼저 로컬 모드로 실행해 어떤 항목이 캡처되는지 확인하고, 조직 연결을 켜기 전에 로컬 대시보드를 검토하세요.
maekon --offline
3. 선택적 조직 연결
온프레미스 배포, 관리자 통제, 조직 용어·관계 지도, 권한, 감사 로그, 통제 실행이 필요한 팀은 Maekon을 ONESHIM의 선택적 엣지 입력·제어 채널로 검토할 수 있습니다. 이 경로는 Apache-2.0 데스크톱 제품과 분리되며, 명시적인 PoC 범위 합의가 필요합니다.
범위가 합의된 PoC라면 조직에서 제공한 엔드포인트를 설정합니다.
# 커스텀 서버 URL 설정 (자신의 URL로 교체):
maekon config set server.api_url "https://your-server.example.com"
maekon config set server.grpc_url "https://grpc.your-server.example.com"
그 후 로그인합니다. 토큰은 플랫폼 키체인(macOS의 Keychain, Windows의 Credential Manager, Linux의 libsecret)에 저장됩니다.
4. 데스크톱 권한 부여
Maekon이 로컬 업무 신호를 수집하려면 플랫폼별 권한이 필요합니다. 첫 실행 시 다음 항목을 요청합니다.
- macOS — 화면 기록, 손쉬운 사용(Accessibility), 입력 모니터링 (설정 → 개인정보 보호 및 보안)
- Windows — UI Automation (첫 캡처 시 자동 부여)
- Linux (X11) — 별도 프롬프트 없이 동작 / Wayland는 XWayland 대체 경로 사용
언제든 이 권한들을 회수할 수 있습니다 — Maekon은 실패하지 않고 해당 기능만 비활성화됩니다.
5. 로컬 후보, 자동화 게이트, 합의된 스트림 확인
독립 모드에서는 메인 윈도우에 최근 로컬 활동, 다음 행동 제안 후보, 승인·정책 검사·샌드박스 프로필·감사 로그가 필요한 자동화 설정이 표시됩니다. 범위가 합의된 ONESHIM PoC에서는 조직 엔드포인트로 설정된 스트림이 추가될 수 있습니다. 모니터링을 멈추려면 트레이 아이콘 → Pause monitoring 을 클릭하세요.
6. 빌드 검증
$ maekon --version
maekon 0.0.1-rc.6 (build: 2026-06-13 | commit: 29f3fce82)
빌드 날짜나 커밋이 예상과 다르다면 오래된 설치본일 수 있으므로 설치 명령을 다시 실행하세요.