AI 및 Coding Agent

Omarchy는 AI Coding Agent를 시스템의 일등 시민으로 대우하지만, 특정 도구만을 강제하지 않습니다. 대신 모든 주요 코딩 Agent CLI가 지연 로딩 런처로 사전 연결되어 있습니다. 런처는 ~/.local/bin/ 내에서 mise로 관리되는 가벼운 스텁(Stub)이며, 실제로 처음 실행할 때 비로소 다운로드가 시작됩니다. 명령어를 입력하고 화면 안내에 따라 인증을 완료하세요:

다른 CLI를 동일한 방식으로 래핑하려면 omarchy-mise-install <package> [command-name]을 실행하세요. omarchy update(또는 mup 별칭)를 실행하면 mise가 관리하는 다른 모든 패키지와 함께 최신 상태로 유지됩니다.

기본 Agent

omarchy default agent <name> 명령을 실행하거나 Omarchy 메뉴(Super + Space)의 Setup > Defaults > Agent에서 기본 Agent를 지정할 수 있습니다. 아직 설치되지 않은 Agent를 선택하면 설치부터 진행됩니다. 새로운 Omarchy 시스템에서는 1회성 알림을 통해 선택을 안내합니다.

지정한 후 Super + Shift + Ctrl + A를 누르면 전용 터미널 창에서 기본 Agent가 즉시 실행됩니다(미지정 상태인 경우 선택 창 표시). omarchy agent prompt "Review this project"처럼 작업을 직접 지정하여 실행할 수도 있습니다. 이 방식으로 실행된 Agent는 각각의 무인 확인 스킵 모드로 작동하므로 자율적으로 작업을 수행합니다! 또한 사용자 홈 디렉터리에 대한 전체 신뢰 권한을 방지하기 위해 $HOME에서 시작된 작업은 ~/Work를 기본 작업 디렉터리로 실행합니다.

터미널 단축키도 제공됩니다: 현재 터미널에서 a를 입력하면 기본 Agent가 인라인 실행되며, c, cx, cy는 각각 OpenCode, Claude Code, Codex를 직접 실행합니다(자동 승인 모드). 테마 변경도 실시간 동기화됩니다: Claude Code, Pi, OpenCode는 Omarchy 테마를 변경할 때 배색이 자동으로 일치됩니다.

상단 바 Agent 모니터링 패널

머신에서 AI 코딩 도구의 사용이 처음 감지되면 상단 바에 Agent 아이콘이 나타납니다(그전까지는 숨겨짐). 패널에서는 모든 구독을 한곳에서 추적합니다: 요금제, 5시간 세션 및 주간 한도 사용률(또는 선불 잔액), 일별 및 모델별 토큰 사용량 통계를 확인할 수 있습니다. Claude Code, Codex, Fireworks가 기본 지원됩니다.

바 아이콘 좌클릭 시 패널이 열리고, 우클릭 시 기본 Agent가 실행됩니다. 사용량 기록은 omarchy agent usage-update에 의해 15분마다 자동 갱신되며, 동기화 폴더를 통해 다른 머신의 사용량을 통합할 수도 있습니다. 자세한 설정은 $OMARCHY_PATH/shell/plugins/agents/의 README를 참조하세요.

프로세스 크래시 자동 진단

Omarchy는 systemd-coredump를 통해 프로세스 크래시를 실시간 감시합니다. 프로그램에 세그멘테이션 오류(Segfault)가 발생하면 'Process crashed' 알림이 뜹니다. 알림을 클릭하면 크래시 정보가 Omarchy의 diagnose-crash 스킬과 함께 기본 Agent로 전달되어 코어 덤프를 분석하고 업스트림에 보고할 만한 문제인지 판단합니다. coredumpctl list에서 PID를 확인한 후 omarchy agent crash <pid>로 수동 실행할 수도 있습니다.

크래시 감시는 기본 활성화되어 있습니다. Trigger > Toggle > Crash Capture(omarchy toggle crash-capture)에서 끌 수 있으며, 끄더라도 omarchy agent crash <pid> 수동 실행은 계속 동작합니다.

데스크톱 GUI 앱

Install > AI 메뉴에는 ChatGPT 공식 데스크톱 앱 및 xAI 모델 대화용 Grok Bot과 같은 GUI 앱도 포함되어 있습니다.

로컬 LLM

Omarchy는 로컬 LLM 모델 구동 방식으로 LM Studio와 Ollama 두 가지를 권장합니다. LM Studio는 오픈 가중치 모델 탐색, 설치, 실행을 위한 완성도 높은 GUI를 제공하여 쉽게 시작할 수 있습니다. Ollama는 유사한 작업을 CLI로 제공합니다. 로컬 모델이 처음이라면 LM Studio를 추천합니다. 둘 다 Omarchy 메뉴의 Install > AI에서 설치할 수 있습니다.

Omarchy Agent 스킬

Agent 스킬(Skill)은 AI가 특정 도구를 효과적으로 활용하도록 돕습니다. Omarchy에는 Hyprland 설정 수정, 상단 바 조정, 테마 제작 등 시스템 커스터마이징을 위한 공식 스킬이 내장되어 있습니다. Claude Code(~/.claude/skills), Codex(~/.codex/skills), Pi(~/.pi/agent/skills), Antigravity(~/.gemini/config/skills), 범용 ~/.agents/skills 경로에 심볼릭 링크되어 주요 하네스가 자동으로 인식합니다.

다만 이 스킬은 실험적 기능으로 다루는 것이 좋습니다. 모델마다 결과가 다를 수 있으므로 먼저 Plan 모드에서 실행하여 변경 사항을 검토하세요. 설정이 꼬인 경우 롤백하거나 터미널에서 omarchy reinstall configs를 실행하여 공식 기본 설정으로 복원할 수 있습니다.