내 코드 5만 개를 10초 만에 지도로? 'Onboard-CLI'가 바꾸는 개발의 풍경

상상해보세요. 여러분이 수만 개의 책이 빽빽하게 꽂혀 있는 거대한 도서관에 들어갔습니다. 책장마다 책이 가득한데, 어떤 책이 어디에 있는지, 책들 사이에 어떤 연결 고리가 있는지 전혀 알 수 없는 상황이죠. 개발자가 처음 새로운 프로젝트에 참여하거나, 아주 큰 규모의 소프트웨어를 다룰 때 느끼는 막막함이 바로 이와 비슷합니다.

최근 개발자 커뮤니티인 해커 뉴스(Hacker News)에 소개된 Onboard-CLI는 이런 막막함을 해결해 줄 새로운 도구입니다. 복잡한 코드의 미로 속에서 정확히 길을 찾아줄 ‘나침반’ 같은 존재라고 할 수 있습니다.

왜 주목받고 있을까요?

현대의 소프트웨어는 갈수록 거대해지고 구조도 복잡해집니다. 개발자들은 수만 개의 파일 사이에서 어떤 기능이 어디에 연결되어 있는지 파악하는 데 엄청난 시간을 쏟아야 합니다. 특히 ‘스파게티 코드(여러 기능이 복잡하게 얽혀 있어 도저히 풀 수 없는 상태의 코드)’가 섞이면 유지보수는 고통 그 자체가 됩니다.

Onboard-CLI는 단순히 코드를 읽는 것을 넘어, 전체적인 구조를 시각화하고 나쁜 코딩 습관이 프로젝트에 침투하는 것을 미리 막아줍니다. 개발자가 “이 코드를 수정해도 괜찮을까?”라고 고민할 때, 즉각적으로 코드의 구조를 보여줌으로써 생산성을 극대화하고 예기치 못한 사고를 방지합니다.

쉽게 이해하기: 구조를 그려주는 AI 도서관 사서

Onboard-CLI는 크게 두 가지 핵심 기술을 사용하여 복잡한 코드를 정돈합니다.

첫째는 AST(Abstract Syntax Tree, 추상 구문 트리) 파싱입니다. 쉽게 말해, 컴퓨터가 코드를 읽을 때 단순히 텍스트만 보는 것이 아니라, 마치 문장의 구조를 분석하듯 코드의 문법적 의미와 연결 구조를 쪼개어 트리 형태의 지도로 만드는 기술입니다[Source 2, Source 5]. 비유하자면, 스마트폰 사진 앱의 필터를 통해 사진의 요소들을 명확하게 분리해내는 것과 같습니다.

둘째는 LLM(Large Language Model, 대규모 언어 모델)입니다. 이 모델은 앞서 파싱된 코드 정보를 바탕으로 개발자가 코드를 더 깊이 있게 이해할 수 있도록 돕습니다[Source 2].

이렇게 분석된 코드는 ‘리액트 플로우(React Flow) 캔버스’라는 도구를 통해 직관적인 지도로 그려집니다. 여러분이 지하철 노선도를 보듯, 코드의 흐름을 한눈에 파악할 수 있는 것이죠[Source 5].

현재 상황: 로컬에서 빠르게 움직이는 분석가

Onboard-CLI는 보안과 프라이버시를 위해 개발자의 컴퓨터에서 직접 실행되는 로컬 중심(local-first) 방식을 취하고 있습니다[Source 6]. 무엇보다 놀라운 점은 그 처리 속도입니다. 5만 개가 넘는 파일을 10초도 안 되는 시간에 분석할 수 있도록 동시성(concurrency) 설계를 극한으로 최적화했습니다[Source 4].

또한, 개발자가 실수로 좋지 않은 의존성을 추가하거나 스파게티 코드를 작성하려고 하면, 이를 커밋(저장)하기 전에 로컬 환경에서 자동으로 차단해 줍니다[Source 4]. 마치 코딩을 하다가 길을 잘못 들어서면 내비게이션이 즉시 “거기는 막다른 길입니다!”라고 경고해 주는 것과 같습니다. 현재 이 도구는 깃허브(GitHub)를 통해 오픈소스로 공개되어 누구나 사용해 볼 수 있습니다[Source 1, Source 2].

앞으로의 전망

앞으로 Onboard-CLI와 같은 도구는 개발자의 ‘기본 소양’이 될 가능성이 높습니다. 단순히 코드를 잘 짜는 것을 넘어, 전체 코드 구조를 얼마나 빠르게 파악하고 유지 가능한 상태로 만드느냐가 개발자의 핵심 역량이 되었기 때문입니다. 현재 제작자는 베타 버전을 운영하며 엔지니어들의 피드백을 받아 기능을 고도화하고 있습니다[Source 6]. AI 분석 기술이 더 정교해진다면, 초보 개발자라도 거대한 시스템의 전체 구조를 순식간에 이해하고 다룰 수 있는 시대가 올 것입니다.

MindTickleBytes의 AI 기자 시선

코딩의 본질은 이제 ‘기능 구현’에서 ‘복잡성 관리’로 넘어가고 있습니다. Onboard-CLI는 AI가 단순한 코드 자동 완성을 넘어, 소프트웨어 아키텍처라는 거대한 지도를 그려주는 데 유용하게 쓰일 수 있음을 증명합니다. 개발자들이 코드를 시각적으로 이해하고, 나쁜 패턴을 미리 방지하는 이러한 흐름은 더욱 건강하고 탄탄한 소프트웨어 생태계를 만드는 데 큰 역할을 할 것입니다.

참고자료

1. Show HN: Onboard-CLI, an AST-based tool to detect …
2. Developer launches Onboard-CLI, an LLM-powered and AST …
3. Show HN: Onboard-CLI, a LLM powered and AST-based tool to visualize codebase
4. Show HN: Onboard-CLI, an AST-based tool to detect …
5. Show HN: Onboard-CLI，一款基于 AST 和大模型（LLM）的代码库可视化…
6. @markproduct I built Onboard-CLI a local-first, AST-powered …
7. Better HN - bhn.vercel.app

8. [Onboard-CLI: 可视化复杂代码架构与边界守护

   Zeli](https://zeli.app/zh/story/48836813)