본문으로 건너뛰기
로그인 둘러보기
개발·코딩·데이터베이스 · 윈도우즈 유틸

ProjectTelescope

0

Project Telescope는 Microsoft에서 제공하는 로컬 첫 번째 관측 가능성 도구로, AI 에이전트의 활동을 기계 밖으로 보내지 않고 확인할 수 있습니다.

Windows관측인공지능

소개

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 스크립트를 실행해야 합니다.