Show GN: Contexty — AI의 컨텍스트를 개발자가 직접 보고 통제할 수 있게 해주는 도구

"왜 당신의 AI는 항상 소문보다 멍청하다고 느껴지는가"

• 컨텍스트가 쌓일수록 모델 성능이 점점 떨어지는 느낌
• 새 채팅으로 넘어가면 이전 전제를 매번 설명해야 하는 번거로움
• /compact를 쓰면 너무 많은 컨텍스트를 잃어버림
• “AI가 지금 정확히 어떤 파일과 코드를 보고 이런 결론을 냈지?”를 알 수가 없음

구글 시니어 엔지니어링 리더 Addy Osmani의 책에서도 비슷한 문제를 지적한 바 있습니다. AI가 빠르게 코드를 만들어주지만, 아키텍처 품질과 컨텍스트 관리는 결국 사람이 챙겨야 한다는 점이죠.
그래서 부산소프트웨어마이스터고등학교 소프트웨어개발과 학생 팀이 이 문제를 직접 해결하기 위해 만든 오픈소스 도구를 소개합니다.

Contexty — AI의 컨텍스트를 개발자가 직접 보고 통제할 수 있게 해주는 도구입니다.

GitHub: https://github.com/ttalkkak-lab/opencode-contexty

주요 기능

HSCMM (Human-supervised Context Management)

현재 AI가 참조하고 있는 컨텍스트를 VSCode Context Explorer 패널에서 트리 형태로 실시간 시각화
포함된 파일, 폴더, 특정 코드 라인까지 확인 가능
불필요한 부분은 즉시 제거, 필요한 파일이나 코드 선택 영역은 직접 추가
에디터 내에서 컨텍스트에 포함된 라인이 하이라이트되어 시각적으로 구분

AASM (Active Agent-supervised Architecture)

프롬프트 단계에서 아키텍처 안티패턴을 미리 감지하는 Sub-Agent

모든 로직을 하나의 파일에 몰아넣기
God Object 생성
전역 가변 상태 남용
등 흔한 실수를 AI가 코드를 생성하기 전에 경고하거나 차단합니다.

DCP (Dynamic Context Pruning)

컨텍스트 한계에 도달하기 전에 자동 압축하면서, 무엇을 압축했는지, 토큰을 얼마나 절약했는지 투명하게 보여줍니다. 필요하면 압축된 부분을 복원(decompress)할 수도 있습니다.

ACPM (Agent Context Permission Management)

AI가 사용할 수 있는 도구(file-read, file-write, shell, web 등)와 파일 경로 권한을 세밀하게 제어합니다.
프리셋으로 저장해 프로젝트별로 쉽게 불러올 수 있습니다.

설치 방법

명령어 실행 후 IDE를 선택하면 OpenCode 확장과 IDE 확장이 자동으로 설치되지만, CLI만으로도 대부분의 기능을 사용할 수 있습니다.
AI 코딩 도구는 점점 강력해지지만, “AI가 지금 무엇을 보고 있는가”를 개발자가 명확히 파악하고 통제할 수 있는 도구는 아직 부족하다고 생각합니다. Contexty는 그 부분을 채우기 위해 시작한 프로젝트입니다.
관심 있으신 분들은 GitHub 저장소를 둘러보시고, 스타·피드백·버그 리포트·기능 제안·PR 언제든 환영입니다!