소개
Project Telescope는 Microsoft에서 제공하는 로컬 첫 번째 관측 가능성 도구로, AI 에이전트의 활동을 기계 밖으로 보내지 않고 확인할 수 있습니다. 버전 0.15.1 기준으로 Windows, macOS, Linux에서 사용할 수 있으며, 에이전트의 세션, 턴, 툴 호출 등을 수집합니다. 이 도구는 텔레 CLI와 대시보드, 내장 컬렉터를 통해 개발자가 에이전트 행동을 디버그하고 최적화하는 데 도움을 줍니다.
상세정보
tele CLI
터미널에서 에이전트, 세션, 턴, 사이드 이펙트를 조회할 수 있는 명령줄 인터페이스입니다.
대시보드
데스크톱 애플리케이션으로 에이전트 활동을 시각적으로 탐색할 수 있습니다.
내장 컬렉터
- GitHub Copilot JSONL – Copilot의 events.jsonl 세션 로그를 스캔
- Claude Code JSONL – Claude Code CLI 세션 내보내기를 가져옴
- MCP Proxy – MCP 서버와의 JSON‑RPC 트래픽을 실시간으로 가로채서 캡처
Collector SDK
Rust 및 C‑ABI 인터페이스를 제공하여 자신만의 컬렉터를 구축할 수 있습니다.
Windows
winget을 사용하여 설치를 진행할 수 있습니다. 명령은 winget install –id Microsoft.ProjectTelescope –exact 입니다. 또는 최신 릴리스에서 MSI 설치 프로그램을 다운로드하여 실행할 수 있습니다.
macOS 및 Linux
릴리스 페이지에서 자신의 플랫폼에 해당하는 아카이브 파일을 다운로드한 뒤 압축을 풀고, telescope 디렉터리로 이동하여 install.sh 스크립트를 실행합니다. macOS에서는 설치 후 quarantine 속성을 제거해야 합니다.
기본 사용법
설치 후 tele setup 명령을 실행하여 기존 MCP 설정을 계측할 수 있습니다. tele status 로 서비스 개요를 확인하고, tele agents list 로 알려진 에이전트 목록을 조회할 수 있습니다. tele sessions list 로 세션 목록을 보고, tele turns list 로 특정 세션의 턴 목록을 확인할 수 있습니다. 모든 명령에 –json 플래그를 추가하면 기계가 읽을 수 있는 출력을 얻을 수 있습니다.
지원 환경·요구사항
Windows, macOS, Linux에서 x64 아키텍처를 지원합니다. Windows에서는 winget 또는 MSI 설치가 필요하며, macOS/Linux에서는 릴리스 아카이브 다운로드 및 install.sh 실행이 필요합니다.
버전·업데이트
현재 버전은 0.15.1이며, 2026-04-29에リリース되었습니다. 자세한 릴리스 노트는 GitHubリリースページを参照してください。
제한·라이선스·확인사항
이 프로젝트는 실험적 단계이며, 데이터 포맷과 API가 변경될 수 있고, 특히 macOS 및 Linux에서의 테스트가 제한적입니다. 라이선스는 MIT입니다。
시스템 요구사항
Windows에서는 winget 패키지 관리자 또는 MSI 설치 프로그램이 필요합니다. macOS 및 Linux에서는 릴리스 페이지에서 플랫폼별 아카이브를 다운로드한 뒤 압축을 풀고 install.sh 스크립트를 실행해야 합니다.


