<p align="center">
<img src="https://raw.githubusercontent.com/antropos17/Aegis/HEAD/docs/images/github-header.svg" width="960" alt="AEGIS. Your agents have access. You deserve visibility. A local security dashboard for AI coding agents.">
</p>
<a id="aegis--ai-agent-monitoring-for-windows"></a>
AEGIS — AI 에이전트가 무엇을 하는지 확인하세요
당신의 에이전트는 접근 권한을 가집니다. 당신은 명확한 가시성을 누릴 자격이 있습니다.
AEGIS는 로컬 AI 에이전트 활동을 하나의 데스크톱 대시보드에 담았습니다. 감지된 Claude Code, Codex, Cursor 및 기타 에이전트 프로세스를 추적하고, 민감 파일 관찰 기록과 네트워크 연결을 조사하며, 프로젝트나 스킬을 실행하기 전에 검토할 수 있습니다. 오픈 소스입니다. Windows 우선 지원이며, 모니터링에 대한 구독료는 없습니다.
<p align="center">
<a href="https://github.com/antropos17/Aegis/releases"><strong aria-label="Download the Windows beta →">Windows 베타 다운로드 →</strong></a>
·
<a href="https://antropos17.github.io/aegis-media/">AEGIS 살펴보기</a>
·
<a href="docs/screenshots/README.md">인터페이스 보기</a>
</p>
<p align="center">
<a href="https://github.com/antropos17/Aegis/actions/workflows/ci.yml"><img src="https://github.com/antropos17/Aegis/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI status"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22d3ee" alt="MIT license"></a>
<a href="#install"><img src="https://img.shields.io/badge/Windows-beta-f59e0b" alt="Windows beta"></a>
<a href="SECURITY.md#privacy-architecture"><img src="https://img.shields.io/badge/monitoring-local-22d3ee" alt="Monitoring data stays local"></a>
</p>
AEGIS Monitoring workspace: agent activity, resource charts and investigation tools
시뮬레이션 데이터로 구현된 인터페이스 미리보기, 2026년 10월 11일 포착됨.
스크린샷 및 출처.
"방금 무슨 일이 일어났지?"에서 검사할 수 있는 무언가로
- 활동의 배후에 있는 에이전트를 추적합니다. 감지된 프로세스, 부모/자식 트리(parent/child trees), 파일 관찰 기록 및 TCP 엔드포인트를 한 곳에서 탐색할 수 있습니다.
- 민감한 활동을 조사합니다. 경고를 열어 증거와 출처 파악(attribution)을 검토하고 나중에 검토할 보고서를 보관합니다.
- 다음 실행 전에 프로젝트를 확인합니다. 선택된 프로젝트, 스킬 또는 에이전트 프로필을 정적 분석 결과(static findings), 구성 증거(configuration evidence) 및 저장된 스냅샷 이후의 변경 사항에 대해 검토합니다.
- Claude Code 사용량을 이해합니다. 일치하는 로컬 세션에서 측정된 토큰 소계(token subtotals)와 자원 차트 옆의 예상 비용을 검사합니다.
- 원하는 곳에 제어 장치를 추가합니다. 선택된 경로에 대해 명시적 액션 정책(explicit action policies) 및 유효성 검사 MCP 게이트웨이(validating MCP gateways)를 구성합니다. 범위 및 설정.
에이전트 플러그인 없이 모니터링 실행됩니다. 이는 관찰하고 기록하며, 자동 차단(automatic blocking)을 위해서는 별도로 구성된 지원 경로가 필요합니다. 인식 및 출처 파악(attribution)은 불완전할 수 있습니다. Windows가 주요 플랫폼이며, macOS와 Linux는 여전히 실험 단계입니다. 기능 및 제한 사항.
설치 · AEGIS 사용하기 · FAQ · 로드맵 · 문서화 · 기여하기
현재 소스 버전: 0.23.0-beta <!-- x-release-please-version -->
각 설치 프로그램은 해당 릴리스 태그의 기능을 포함합니다.
다운로드 확인 · 베타 준비 상태
시작하기
첫 데스크톱 세션의 경우: 검증된 베타 버전을 설치하고 코딩 에이전트가 실행되는 동안 **모니터링(Monitoring)**을 열어 관찰된 활동을 검사할 에이전트를 선택합니다. 생소한 코드를 실행하기 전 검토의 경우, **로컬 보안(Local security)**을 열고 프로젝트 폴더를 선택합니다. 이러한 워크플로우에는 제공업체 API 키가 필요하지 않습니다.
<table>
<thead>
<tr>
<th>다음 단계</th>
<th>어디로 가야 할까요</th>
</tr>
</thead>
<tbody>
<tr>
<td>인터페이스 살펴보기</td>
<td>설치 없이 [스크린샷 보기](docs/screenshots/README.md)하거나, 소스에서 [브라우저 미리보기 실행](#browser-preview)하십시오. 둘 다 시뮬레이션된 데이터를 사용합니다.</td>
</tr>
</tbody></table>
<a id="capabilities-at-a-glance"></a>
<a id="what-aegis-observes"></a>
<a id="monitor-first"></a>
<a id="observe-your-agents"></a>
<a id="review-before-use"></a>
<a id="control-selected-actions"></a>
AEGIS의 기능
<table>
<thead>
<tr>
<th>영역</th>
<th>커버리지</th>
</tr>
</thead>
<tbody>
<tr>
<td>프로세스</td>
<td>에이전트 112개 (프로세스 이름 시그니처 265개), 프로세스 트리, IDE-호스트 및 확장 감지; Windows가 주력이며, macOS/Linux는 실험적입니다.</td>
</tr>
</tbody>
</table>
모니터링을 위해 에이전트 플러그인이나 구독이 필요하지 않습니다. 기본 모니터링은 관찰하고 기록할 뿐이며, 명령을 자동으로 차단하거나 에이전트를 격리하지는 않습니다. 종료(Kill), 일시 중지(suspend), 재개(resume)는 수동 작업입니다. [전체 기능 가이드](docs/CAPABILITIES.md)를 참조하십시오.
<a id="download"></a>
설치
<a id="windows-installer"></a>
Windows
동일한 GitHub 릴리스에서 설치 프로그램, manifest.json, 그리고 manifest.json.sig를 다운로드한 후, 오프라인 검증을 따르십시오. 릴리스 노트에 해당 설치 프로그램의 기능이 설명되어 있습니다.
검증 후 첫 번째 베타 버전을 수동으로 설치해야 합니다: 공개된 0.17.0-alpha 업데이트기는 베타 릴리스를 감지할 수 없습니다. 0.14.1-alpha 또는 그 이전 버전에서 업그레이드하는 경우, 서명된 인앱(in-app) 업데이트를 사용하기 전에 0.15.0-alpha 이상 버전을 수동으로 설치하십시오.
소스에서 (From source)
Node.js 24.16.0 이상 또는 24.x 라인의 버전을 요구합니다. 소스는 Electron 45 및 64비트 플랫폼을 사용하며, macOS는 버전 13 이상이 필요합니다. Windows 10/11이 주력이며, macOS/Linux는 여전히 실험적입니다.
git clone https://github.com/antropos17/Aegis.git
cd Aegis
npm ci
...
윈도우에서는 네이티브 Job/MCP 경로 및 native-helper 테스트를 위해 npm ci 실행 후 npm run build:sidecar를 실행합니다. 리눅스 프로세스 동작은 추가적으로 /usr/bin/python3에 있는 Python 3.9 이상 버전과 커널 pidfd 지원을 요구합니다. 자세한 내용은 리눅스 프로세스 제어를 참조하세요. 개발 워크플로우는 헬퍼 빌드 및 검사를 다룹니다.
<a id="try-without-ai-agents"></a>
브라우저 미리보기 (Browser preview)
npm ci 이후 소스 체크아웃에서 다음을 실행합니다:
미리보기는 데스크톱 구성 요소를 공유하고 격리된 호스트를 사용하여 시뮬레이션 데이터를 사용합니다. 네이티브 내보내기 및 제공자 요청을 비활성화합니다. npm run frontend:build:preview가 해당 미리보기를 빌드하며, npm run build:renderer는 데스크톱 렌더러를 빌드합니다.
<a id="start-with-a-task"></a>
AEGIS 사용하기 (Use AEGIS)
소스는 기본적으로 고급(Advanced) 탐색을 엽니다. 설정의 **간단 인터페이스(Simple interface)**는 조사, 파일 검사 및 설정을 제공하며, 저장된 간단한 선택 사항은 유지됩니다.
이들은 2026년 10월 11일의 시뮬레이션된 소스 UI 캡처본입니다.
모든 스크린샷 및 출처.
Windows x64 패키지에는 실험적인 Kernel-File 읽기가 포함됩니다. **이벤트(Events)**에서 로컬 폴더를 선택하고 수동 UAC 동의로 명시적으로 캡처를 시작합니다. 이는 시작 시 꺼져 있으며, 중지(Stop), 모니터링 일시 중지(monitoring pause), 일시 정지(suspend) 또는 종료 시 작동을 멈춥니다. 이벤트는 읽기 내용, 검증된 발행 에이전트 및 경로 규칙으로부터의 **잠재적 민감 읽기(Potential sensitive read)**를 표시할 수 있습니다. 경로는 후보로 남아 있으며, 이 레이블은 악성 의도를 확립하거나 위험 점수를 변경하지 않습니다.
모니터링 데이터는 로컬에 유지되며, 사용량 원격 측정(usage telemetry)이나 클라우드 동기화가 없습니다. 엔드포인트 이름 지정에는 DNS를 사용하며, 업데이트 확인은 GitHub에 문의하십시오. 선택적 Anthropic 분석은 요청 시 자체 API 키를 사용하여 활동 메타데이터를 전송하며 해당 서비스의 요금이 발생합니다. 개인 정보 보호 및 키 처리를 참조하십시오.
<a id="opt-in-action-control"></a>
<a id="selected-action-controls"></a>
선택된 작업 제어 (Selected action controls)
이 경로는 명시적인 설정이 필요하며 선택된 작업만을 다룹니다. 다른 에이전트 도구, 임의의 MCP 트래픽 또는 경로 외부의 활동은 가로채지 않습니다.
선택적 영구 권한 부여(persistent grants), 알려진 비밀 검사(known-secret checks) 및 실시간 경로 관찰(live route observation)은 별도의 계약을 가집니다. 구성 확인만으로는 실행 권한이 부여되지 않으며, 관찰은 제공업체 신원 또는 차단을 검증하지 않습니다. 클라이언트 설정은 운영자 통제 하에 유지됩니다. 터미널 미리 보기 및 생성된 구성에는 개인 경로 또는 비밀 정보가 포함될 수 있으므로 비공개로 유지하십시오. 설정 가이드를 참조하십시오.
실험적 보호된 Windows 게스트 (Experimental protected Windows guests)
관리형 레포지토리 API는 사설 Hyper-V VM을 생성하고, 신뢰할 수 있는 Windows VHDX에서 원본 디스크를 복원하며, 새로운 표준 게스트 사용자로서 하나의 제한된 실행 파일(bounded executable)을 실행할 수 있습니다. 실제 부팅, 할당량 거부, 후손 정리 및 VM 제거는 기록된 출처에서 확인 가능합니다.
게스트는 NIC가 없으며, 개인 데스크톱(private desktop), 512 MiB 할당 할당량(allocation quota), 32개 프로세스/512 MiB 작업(Job), 그리고 120초 실행 제한을 가집니다. 이를 위해서는 관리용 임시 실험실(administrative disposable lab)이 필요합니다. 일반 설치형 호출자 실행은 비활성화 상태로 유지됩니다(launchAllowed=false); 완전한 세션 통합 및 독립적인 A1–A4 승인은 여전히 열려 있습니다. 관리 계약 · 보호 로드맵.
<a id="latest-source"></a>
현재 개발 현황
당장의 목표는 사용 가능한 Windows Claude Guard입니다: 설치, 지원되는 경로 실행, 일반 작업 허용, 선언된 위험한 시도 차단 및 결과 검사입니다. 이는 활발하게 진행 중인 전달 목표이며, 전체 설치형 경로 승인은 여전히 열려 있습니다. 실행 순서와 현재 증거 및 격차를 참조하십시오.
완료 계획은 현재 작업과 그 승인 경계를 추적합니다. 소스 변경 사항 및 개발 컨텍스트는 활성 체크아웃(active checkout)과 증거를 식별합니다. 각 자격 기록은 자체 테스트된 리비전과 패키지 이름을 명시하며, 소스 변경 사항이 게시된 설치 파일을 업데이트하지는 않습니다.
최근 Observatory 작업은 키보드 탐색, 포커스, 현지화 및 관찰 상태와 설정 상태의 명확성을 #1127과 #1128에서 개선했습니다. 이러한 소스 변경 사항은 설치형 애플리케이션(installed-application) 또는 네이티브 센서 승인을 확립하지 않습니다.
다음은 2026년 10월 18일자 역사적 스냅샷으로, #975을 거쳐 96b63b16에 있습니다.
<details>
<summary>엔지니어링 마일스톤 및 날짜별 네이티브 자격 증거 읽기</summary>
#976는 첫 번째 스코프 읽기 전에 감지된 스레드를 준비합니다. 이 PR의 live qualification은 README 워밍업 없이 진정한 첫 번째 읽기 과정을 통과했으며, 하나의 진단용 Windows 패키지에 대한 지속적 읽기 회귀(regression) 현상도 테스트했습니다. 두 경우 모두 검증된 에이전트 읽기와 잠재적 위험을 보여주었으며; 추가 관찰 사항은 미검증 상태로 남을 수 있습니다. 이 후보는 진단 프로필과 함께 테스트되었습니다. 일반적인 패키지화된 제어(Ordinary packaged controls)는 자체 설정 및 자격 검증 과정을 거칩니다.
