시작하기
이 가이드는 Maekon을 처음 실행하고 에이전트가 서버와 정상적으로 통신 하는지 확인하는 과정을 안내합니다.
1. Maekon 실행
설치 후 응용 프로그램 폴더(macOS), 시작 메뉴(Windows), 또는 maekon 명령어(Linux)로 실행하세요. 앱은 시스템 트레이에 최소화된 상태로 시작됩니다 — 트레이 아이콘을 클릭하면 메인 윈도우가 열립니다.
2. 서버 연결
Maekon은 지식 그래프를 보관하고 제안을 오케스트레이션하는 서버 엔드포인트와 페어링됩니다. 두 가지 옵션이 있습니다.
옵션 A — 공용 데모 서버 (api.oneshim.thengd.com)
평가 용도로 적합합니다. 환영 화면에서 Sign in with email을 클릭하고, OAuth 절차를 완료하면 연결됩니다.
옵션 B — 자체 호스팅 서버
서버를 로컬에서 실행했거나 직접 배포했다면 엔드포인트를 설정하세요.
# 커스텀 서버 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)에 저장됩니다.
3. 데스크톱 권한 부여
Maekon이 컨텍스트를 캡처하려면 플랫폼별 권한이 필요합니다. 첫 실행 시 다음 항목을 요청합니다.
- macOS — 화면 기록, 손쉬운 사용(Accessibility), 입력 모니터링 (설정 → 개인정보 보호 및 보안)
- Windows — UI Automation (첫 캡처 시 자동 부여)
- Linux (X11) — 별도 프롬프트 없이 동작 / Wayland는 XWayland fallback 사용
언제든 이 권한들을 회수할 수 있습니다 — Maekon은 실패하지 않고 해당 기능만 비활성화됩니다.
4. 제안 스트림 확인
로그인 후 Maekon은 서버와 gRPC 스트림을 엽니다. 트레이 아이콘이 녹색으로 바뀌고 메인 윈도우 타임라인에 최근 활동이 표시됩니다. 스트림을 멈추려면 트레이 아이콘 → Pause monitoring 을 클릭하세요.
5. 빌드 검증
$ maekon --version
maekon 0.0.1-rc.3 (build: 2026-05-05 | commit: 628908505)
빌드 날짜나 커밋이 예상과 다르다면 오래된 설치본일 수 있으므로 빠른 설치 스크립트를 다시 실행하세요.