코드에서 뽑아낸 제품 맵

당신의 앱을 한 장의 맵으로 이해하세요.

웹과 네이티브 앱 모두 지원합니다 — 데이터 모델은 플랫폼에 종속되지 않아, 어떤 스택이든 어댑터로 연결됩니다.

Alkahest는 코드베이스를 정적 분석해 화면 단위 제품 맵을 역설계합니다 — 모든 화면, 화면 간 이동, 그리고 각 화면이 호출하는 데이터까지. 링크 하나로 공유하면, 팀의 누구나 설치 없이 브라우저에서 바로 봅니다.

무료로 시작하기 작동 방식 보기 ↓

$npm install -g @cr8rcho/alkahest

alkahest view — product map

Alkahest를 쓰는 이유

코드베이스에 한 번도 딸려온 적 없던 그 지도.

새 팀원, PM, 디자이너가 제품이 어떻게 얽혀 있는지 알기 위해 라우터 코드를 읽을 필요는 없습니다. Alkahest가 소스에서 그 그림을 뽑아내고, 늘 최신 상태로 유지합니다.

정적 분석, 실행 불필요

소스를 직접 파싱합니다. 계측 코드도, 앱 실행도, CI 연동도 필요 없습니다. 저장소를 가리키고 스캔만 하면 됩니다.

화면, 이동, 데이터

모든 화면이 노드, 화면 간 이동이 엣지, 각 화면이 호출하는 API/데이터까지 — 흐름과 의존 관계가 한눈에 보입니다.

링크로 공유

맵을 호스팅 뷰어에 게시하고 URL을 보내세요. 팀원은 브라우저에서 그래프를 탐색합니다 — 설치도, 체크아웃도 없이 늘 최신 스캔으로.

CLI & MCP

터미널에서 바로 실행하거나, MCP로 AI 에이전트에 연결해 코딩하면서 제품 맵을 읽게 하세요.

오픈 코어

CLI와 그래프 렌더러는 오픈소스(MIT)입니다. 호스팅 서비스가 그 위에 계정, 공유, 팀 플랜을 더합니다.

항상 최신

맵이 코드에서 파생되므로, 다시 스캔하면 현실을 그대로 반영합니다. 재게시하면 링크가 갱신됩니다 — 손으로 관리하던 낡은 다이어그램은 이제 없습니다.

작동 방식

저장소에서 공유 가능한 맵까지, 명령어 세 개.

프로젝트 스캔

앱 루트에서 alkahest scan을 실행하세요. Alkahest가 소스를 파싱해 화면 단위 맵을 로컬에 만듭니다 — 언제든 alkahest view로 미리 볼 수 있습니다.
CLI 인증

계정 페이지에서 게시 토큰을 만들고 alkahest login --token <token>을 실행하세요. 토큰이 CLI를 계정과 연결합니다.
링크 게시

alkahest publish가 맵을 업로드하고 공유 가능한 URL을 돌려줍니다. 팀에 보내면 브라우저에서 인터랙티브 그래프를 엽니다.

# 1 · CLI 설치 (GitHub에서 — 아직 npm 미배포)
npm install -g @cr8rcho/alkahest

# 2 · 프로젝트 맵 만들기 (로컬 미리보기)
alkahest scan
alkahest view

# 3 · 계정 연결
alkahest login --token <your-token>

# 4 · 공유 링크 게시
alkahest publish
# → https://alkahest.app/p/your-project

빠른 시작

붙여넣기만 하면, 에이전트가 앱을 맵으로 만듭니다.

프롬프트 하나를 붙여넣으면 에이전트가 Alkahest를 설치하고, MCP로 연결하고, 프로젝트를 스캔해 맵까지 만들어 줍니다 — 수동 설정도, API 키도 없이. 쓰시는 도구를 고르세요:

▶ Claude Code에 이걸 붙여넣으세요 — 설치·연결·프로젝트 맵 생성까지 한 번에

이 프로젝트에 Alkahest를 처음부터 끝까지 세팅해줘:
1. CLI 설치:  npm install -g @cr8rcho/alkahest
2. MCP로 너와 연결:  claude mcp add alkahest -s project -- alkahest mcp
3. 제품 맵 생성:  alkahest scan
4. 화면 개요를 먼저 보여주고, 가장 중요한 화면들에 대해 한 줄 요약과 짧은 PRD를 작성해줘 (alkahest의 set_summary / set_prd 도구가 있으면 그걸 사용).
5. 대시보드 열기:  alkahest view

참고: MCP 서버를 추가한 뒤에는 Claude Code를 한 번 재시작해야 alkahest 도구가 로드됩니다 — 그래야 요약과 PRD를 맵에 기록할 수 있습니다.

▶ Codex에 이걸 붙여넣으세요 — 설치·등록·프로젝트 맵 생성까지 한 번에

이 저장소에 Alkahest를 처음부터 끝까지 세팅해줘:
1. CLI 설치:  npm install -g @cr8rcho/alkahest
2. ~/.codex/config.toml에 아래를 추가해 MCP 서버로 등록:
     [mcp_servers.alkahest]
     command = "alkahest"
     args = ["mcp"]
3. 제품 맵 생성:  alkahest scan
4. 화면 개요를 먼저 보여주고, 가장 중요한 화면들에 대해 한 줄 요약과 짧은 PRD를 작성해줘 (alkahest의 set_summary / set_prd 도구가 있으면 그걸 사용).
5. 대시보드 열기:  alkahest view

참고: config.toml을 편집한 뒤에는 Codex를 한 번 재시작해야 alkahest MCP 도구가 로드됩니다 — 그래야 요약과 PRD를 맵에 기록할 수 있습니다.

맵을 공유하고 싶으세요? 무료 계정을 만들어 게시 토큰을 발급받은 뒤, 에이전트에게 alkahest login --token <token>과 alkahest publish를 실행하라고 하세요 — 누구나 열 수 있는 링크가 생깁니다. 수동으로 하고 싶다면 작동 방식을 참고하세요.

자주 묻는 질문

궁금한 점, 정리했습니다.

Alkahest가 실제로 만들어 주는 건 뭔가요?

화면 단위 제품 맵입니다. 앱의 각 화면이 노드, 화면 간 이동이 엣지가 되고, 화면이 호출하는 API/데이터가 거기에 붙습니다. 코드 자체에서 파생된, 제품이 어떻게 얽혀 있는지에 대한 조감도입니다.

어떤 프레임워크를 지원하나요?

현재: React (Next.js — app & pages 라우터 —, Vite/CRA의 React Router, Remix/React Router 7), Vue (Nuxt, Vue Router), Angular, Svelte (SvelteKit), Astro, React Native (Expo Router, React Navigation), SwiftUI·UIKit (iOS), Jetpack Compose (Android), Flutter, 서버 렌더링 Django·Flask·Rails, 그리고 순수 멀티페이지 HTML까지. 데이터 모델이 플랫폼에 종속되지 않아, 더 많은 스택이 플러그인 가능한 어댑터로 추가됩니다. Alkahest는 소스를 정적으로 읽으며 — 앱을 실행하지 않으므로 계측할 것이 없습니다.

무언가를 직접 호스팅해야 하나요?

아니요. CLI는 로컬에서 동작하고, alkahest publish가 맵을 alkahest.app의 호스팅 뷰어에 업로드합니다. 링크가 있는 사람은 누구나 브라우저에서 그래프를 탐색할 수 있습니다 — 설치나 저장소 접근 권한이 필요 없습니다.

제 소스 코드가 업로드되나요?

아니요. 게시되는 것은 파생된 맵(화면, 화면 간 이동, 데이터 호출 메타데이터)뿐이며, 소스 파일은 올라가지 않습니다.

오픈소스인가요?

네 — 오픈 코어입니다. CLI와 그래프 렌더러는 MIT 라이선스로 GitHub에 공개돼 있습니다. 호스팅 서비스(계정, 공유, 팀 플랜)가 그 위에 얹힌 유료 레이어입니다.