MyAgents

소개

MyAgents는 Windows 트레이에서 실행되어 Claude Code와 Codex CLI 세션을 한눈에 모니터링하는 프로그램입니다. 실시간 상태 표시, 클릭으로 세션 포커스 이동, 공식 5시간/7일 사용량 막대 그래프를 제공합니다.

주요 기능

• 트레이 아이콘에서 현재 활성인 Claude Code 및 Codex 세션 목록 표시
• 각 세션에 오렌지색( Claude ) 또는 녹색( Codex ) 태그로 구분
• 세션 상태(IdeaProjects, Ready 등)와 5h/7d 기준 사용량 막대 그래프 표시
• 세션 이름을 클릭해 해당 터미널 창으로 바로 포커스 이동
• 위젯 표시/숨김, 새로 고침, 진단 내보내기, WSL 재시작(멈춘 세션 복구) 등 설정 메뉴 제공
• 세션이 주의가 필요할 때 알림 옵션, Codex 세션 표시 여부, Windows 시작 시 자동 실행, 후크 복구/제거 기능 포함

지원 환경

Windows 운영 체제에서 트레이 애플리케이션으로 실행됩니다. Claude Code 및 Codex CLI가 설치되어 있고 활성 세션이 있는 환경에서 사용 가능합니다.

기본 사용법

1. MyAgents를 실행하면 시스템 트레이에 아이콘이 나타납니다.
2. 아이콘을 클릭하거나 우클릭해 메뉴에서 Show / hide widget을 선택하면 세션 목록 창을 볼 수 있습니다.
3. 세션 목록에서는 각 세션의 이름, 상태, 태그 및 5h/7d 사용량 그래프를 확인할 수 있습니다.
4. 세션 이름을 클릭하면 해당 세션의 터미널 창으로 포커스가 이동합니다.
5. 설정 메뉴에서 Refresh로 정보를 갱신하고, Export diagnostics로 진단 정보를 내보낼 수 있습니다.
6. WSL 관련 문제가 있을 경우 Restart WSL (fix stuck sessions)를 사용하고, Start with Windows 옵션으로 부팅 시 자동 실행을 설정할 수 있습니다.

제한 사항 및 체크포인트

• Claude Code 또는 Codex CLI 세션이 실행 중이지 않다면 트레이에 표시되는 세션이 없습니다.
• WSL 환경을 사용하는 경우 세션이 멈췄을 때 Restart WSL (fix stuck sessions) 기능을 통해 복구를 시도할 수 있습니다.
• 사용량 그래프는 공식 5시간/7일 기준이며, 토큰 기반이 아닌 실제 세션 활성 시간을 나타냅니다.

자주 묻는 질문(FAQ)

1. MyAgents는 어떤 프로그램을 모니터링하나요? Claude Code와 Codex CLI 세션을 실시간으로 추적합니다.
2. 사용량 그래프는 어떻게 읽나요? 각 세션 아래에 표시된 막대는 공식 5시간( Claude ) 또는 7일( Codex ) 기준 사용 비율을 보여줍니다. 예를 들어 60%는 해당 기간 중 60%가 사용되었음을 의미합니다.
3. WSL 세션이 응답하지 않을 때는 어떻게 하나요? 설정 메뉴의 Restart WSL (fix stuck sessions)를 선택해 WSL을 재시작하면 멈춘 세션을 복구할 수 있습니다.
4. 프로그램을 시작할 때 자동으로 트레이에 띄우려면 어떻게 설정하나요? 설정에서 Start with Windows 옵션을 켜면 로그인 시 자동으로 실행됩니다.

화면으로 보는 주요 기능

세션 목록 화면

'SESSIONS' 섹션에 두 개의 세션이 표시되어 있으며, 각각 'Testing session on Claude'와 'Testing Session on Codex'입니다. 'Claude' 세션은 오른쪽 상단에 오렌지색 태그가 있고, 'Codex' 세션은 녹색 태그가 있습니다. 두 세션 모두 'IdeaProjects'와 'Ready' 상태를 보여줍니다. 하단에는 'Claude'와 'Codex'의 사용량이 5h와 7d 기준으로 표시된 바 그래프가 있으며, 'Claude'는 0% (리셋 4h 56m), 'Codex'는 15% (리셋 3d 7h)입니다. 하단에는 'MyAgents', '2 open', '0 working'이라는 상태 메시지가 있습니다.

세션 사용량 정보 화면

'Claude'와 'Codex' 세션의 사용량이 5h와 7d 기준으로 표시된 바 그래프가 있습니다. 'Claude'는 60% (리셋 41m), 'Codex'는 57% (리셋 43m)입니다. 하단에는 'MyAgents', '5 open', '0 working'이라는 상태 메시지가 있습니다.

설정 메뉴 화면

'Show / hide widget', 'Refresh', 'Export diagnostics', 'Restart WSL (fix stuck sessions)', 'Show usage (5h / 7d — official, no token)', 'Notify when a session needs me', 'Show Codex sessions', 'Position', 'Start with Windows', 'Repair hooks', 'Uninstall hooks', 'Exit' 등의 메뉴 항목이 있습니다. 'Show usage (5h / 7d — official, no token)', 'Notify when a session needs me', 'Show Codex sessions', 'Start with Windows' 항목은 체크박스가 선택되어 있습니다.