Claude Code, OpenCode, Codex, Cursor 등 여러 코딩 에이전트의 스킬을 확인·설치·업데이트하는 터미널 UI입니다.
Qiuner/birdview
AI 코딩 도구가 프로젝트 구조와 제약, 변경 범위를 HTML 맵으로 그린 뒤 확인을 기다리게 하는 에이전트 스킬입니다.
- 스타
- 691
- 포크
- 75
- 열린 이슈
- 0
- 마지막 커밋
- 11일 전
어떤 프로젝트인가요?
Birdview는 Codex, Claude Code 같은 AI 코딩 에이전트를 위한 스킬입니다. 변경을 시작하기 전에 에이전트가 프로젝트의 모듈과 각 모듈의 역할 및 연결 관계, 적용되는 규칙, 수정할 예정인 파일을 하나의 맵에 정리합니다. 사용자가 계획을 검토하고 확인한 뒤에야 코드 편집이 시작됩니다.
결과물은 서버 없이 브라우저에서 열 수 있는 독립형 HTML 페이지입니다. 페이지에는 Architecture, Constraints, Review 뷰가 있습니다. 작업 활동 정보가 제공되면 Architecture 뷰가 변경 사항 뷰로 바뀌어 변경 대상으로 선언된 모듈과 파일을 표시하고, 계획 범위 밖에 있지만 직접 연결된 모듈을 강조합니다. 각 모듈에 대한 주장은 소스 근거로 뒷받침됩니다.
버전 0.4.0에는 현재 구조와 재설계안을 소스 인용과 함께 그려 주는 아키텍처 검토 워크플로와, 트리거가 겹치는 스킬을 보고하는 스킬 호환성 감사 기능이 추가됐습니다. Birdview는 에이전트의 동작을 자동으로 관찰하지 않으며 Git diff, 테스트 또는 코드 리뷰를 대체하지 않습니다.
핵심 기능
- 01모듈과 각 모듈의 역할 및 연결 관계를 인터랙티브 HTML 맵으로 그립니다.
- 02에이전트가 변경 대상으로 선언한 파일과 모듈을 표시하고, 범위 밖의 영향도 보여 줍니다.
- 03기본 워크플로에서 구현 전에 사용자가 계획을 확인하도록 합니다.
- 04인용된 소스 근거와 재설계안을 보여 주는 아키텍처 검토 뷰를 제공합니다.
- 05트리거가 겹치는 스킬을 보고하는 스킬 호환성 감사 기능을 포함합니다.
- 06브라우저에서 오프라인으로 사용할 수 있는 독립형 페이지를 출력합니다.
활용 사례
- AI 에이전트가 코드베이스를 수정하기 전에 변경 계획을 검토할 때.
- 에이전트가 작업할 낯선 프로젝트의 아키텍처를 빠르게 파악할 때.
- 요청한 변경이 의도한 범위를 넘어 다른 모듈에까지 영향을 미치는지 확인할 때.
- 소스 근거를 바탕으로 모듈 경계와 제안된 리팩터링을 검토할 때.
빠른 시작
- 1
skills CLI로 skill을 설치합니다
npx skills add Qiuner/birdview --skill birdview - 2
Codex에서 skill을 호출합니다(맵만 생성, 코드 수정 없음)
$birdview Show this project's architecture and constraints; do not edit code. - 3
Claude Code에서 skill을 호출합니다(맵만 생성, 코드 수정 없음)
/birdview Show this project's architecture and constraints; do not edit code.
사용 전 알아둘 점
- Birdview는 에이전트의 모든 작업을 자동으로 관찰하지 않으며, Git diff, 테스트 또는 코드 리뷰를 대체하지 않습니다.
- 제약 조건 뷰를 사용하려면 엄선된 제약 조건 카탈로그가 필요하며, 바로 열어 볼 수 있는 제약 조건 예시는 아직 없습니다.
- 기본적으로 skill은 필요할 때 실행됩니다. HTML 페이지는 안내용이며 쓰기 잠금을 강제하지 않습니다.
토픽
자주 묻는 질문
- birdview은(는) 무엇인가요?
- AI 코딩 도구가 프로젝트 구조와 제약, 변경 범위를 HTML 맵으로 그린 뒤 확인을 기다리게 하는 에이전트 스킬입니다. Birdview는 Codex, Claude Code 같은 AI 코딩 에이전트를 위한 스킬입니다. 변경을 시작하기 전에 에이전트가 프로젝트의 모듈과 각 모듈의 역할 및 연결 관계, 적용되는 규칙, 수정할 예정인 파일을 하나의 맵에 정리합니다. 사용자가 계획을 검토하고 확인한 뒤에야 코드 편집이 시작됩니다.
- birdview은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- birdview은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- birdview은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. birdview의 마지막 커밋은 2026년 10월 9일입니다.
- birdview은(는) 어디에 사용할 수 있나요?
- AI 에이전트가 코드베이스를 수정하기 전에 변경 계획을 검토할 때. 에이전트가 작업할 낯선 프로젝트의 아키텍처를 빠르게 파악할 때. 요청한 변경이 의도한 범위를 넘어 다른 모듈에까지 영향을 미치는지 확인할 때. 소스 근거를 바탕으로 모듈 경계와 제안된 리팩터링을 검토할 때.
- birdview는 어떻게 설치하나요?
- skills CLI로 skill을 설치합니다: npx skills add Qiuner/birdview --skill birdview Codex에서 skill을 호출합니다(맵만 생성, 코드 수정 없음): $birdview Show this project's architecture and constraints; do not edit code. Claude Code에서 skill을 호출합니다(맵만 생성, 코드 수정 없음): /birdview Show this project's architecture and constraints; do not edit code.
- birdview은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Qiuner/birdview
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
코딩 에이전트를 지속되는 창에서 실행하고 작업·차단·대기 상태를 추적하며, CLI와 소켓 API로 에이전트가 직접 제어할 수 있는 Rust 터미널 워크스페이스입니다.
libghostty 기반의 macOS 네이티브 터미널로, 세로 탭과 에이전트 상태 알림을 제공하며 AI 코딩 에이전트를 병렬 실행할 수 있는 스크립트 가능한 CLI를 지원합니다.
코딩 에이전트를 위한 버전 관리: 커밋을 만든 에이전트 세션과 연결하고, 여러 에이전트가 프로젝트 메모리를 공유합니다.
C4 기반 표기법으로 코드 기반 소프트웨어 아키텍처 다이어그램을 생성하는 모델링 언어와 도구 체인
지속형 터미널 작업 공간에서 여러 AI 코딩 에이전트를 실행·모니터링·조율하는 미션 컨트롤 TUI