FiboCode

빠른 시작

FiboCode는 편집기 안에서 코드, 문서, 그래프를 바탕으로 코드와 함께 성장하는 지식 베이스를 구축하고, 그 공통 맥락을 원하는 Agent CLI에 제공합니다. 이를 통해 사람과 에이전트가 함께 코드를 이해하고 탐색하며 변경할 수 있습니다.

이해는 코드와 함께 자랍니다.

일상에서는 두 가지 방식으로 사용합니다. 하나는 작성을 위한 것이고, 다른 하나는 읽기를 위한 것입니다.

사용 방식하는 일FiboCode가 더하는 것
향상된 터미널 워크플로이미 신뢰하는 Agent CLI로 코딩workspace를 이해하는 컨텍스트, 자동 기록되는 파일 변경, IDE 수준의 hunk별 검토
코드 분석과 이해익숙하지 않은 저장소를 인수하거나 시스템이 지금의 모습이 된 이유 파악저장소 전체 설명 문서, 개념 그래프, 코드·텍스트·그래프 사이의 양방향 이동

두 경로는 동일하게 시작합니다. 앱을 설치하고 workspace를 연 다음 모델을 구성하세요.

다운로드 및 설치

FiboCode Releases 페이지에서 최신 설치 파일을 받으세요.

OS패키지
macOS (Apple Silicon).dmg 디스크 이미지
Windows.exe 설치 프로그램
Linux.AppImage
  • macOS: .dmg를 열고 FiboCode를 Applications로 드래그합니다.
  • Windows: .exe 설치 프로그램을 실행하고 안내를 따릅니다.

홈페이지의 Download 버튼은 항상 최신 릴리스를 자동으로 가리키므로 버전 번호를 찾아다닐 필요가 없습니다.

시작하기 전에

1. workspace를 엽니다. workspace 패널에서 “Open Folder”를 클릭해 코드베이스를 선택하거나 폴더를 패널에 바로 드래그하세요. .zip 파일 드래그는 지원하지 않습니다. 나중에는 “Recently Opened”로 workspace를 전환할 수 있습니다. FiboCode는 단일 파일이 아니라 저장소 전체를 이해의 단위로 다룹니다.

2. 모델을 구성합니다. System Config → Model Config → Add Provider로 이동해 Provider Name, Interface Type(OpenAI 호환), Base URL, API Key, Model Name을 입력하고 저장한 뒤 Main Model을 선택합니다. 지연 시간이 짧은 공급자를 Fast Model로 지정하면 지연에 민감한 호출에서 우선 사용합니다. Advanced Settings에서는 동시성, 시간 제한, 최대 출력 token을 설정합니다.

모델이 준비되면 세 가지 기능이 활성화됩니다.

  • Diff 요약 — 소스 제어 패널에서 파일이나 디렉터리에 마우스를 올리면 변경 사항을 즉시 요약하고, commit 전에 한 번의 클릭으로 commit message를 생성합니다.
  • 코드 완성 — 편집기의 AI 제안 패널에서 제안을 하나씩 수락하거나 거절합니다.
  • 코드 분석 — 저장소 전체를 분석해 디렉터리 및 파일 수준의 설명 문서와 개념 그래프를 만듭니다.

3. Agent에 Fibo Skills를 설치합니다(선택 사항, 권장). Fibo Skills는 터미널의 Agent CLI에 spec → plan → execute → sync 워크플로를 추가하고, 명세·계획·변경 기록을 .fibo/ 문서 시스템에 작성하도록 Agent에 지시합니다. FiboCode 자체는 이 변경 이력을 자동으로 만들지 않습니다. Agent가 기록을 계속 관리하게 하려면 Fibo Skills를 설치해 사용하세요. 설치 방법은 Fibo Skills를 확인하세요.

사용법 1: 향상된 터미널 워크플로

이미 신뢰하는 Agent CLI와 기존 습관을 그대로 유지하세요. FiboCode는 그 주변의 컨텍스트와 검토를 채워 줍니다.

  1. CLI 모드로 전환해 코딩을 시작합니다. 채팅 패널을 CLI 모드로 바꾸고 터미널을 연 뒤 Claude Code, Codex 또는 원하는 Agent CLI를 실행합니다.
  2. 채팅 모드로 돌아와 변경을 정리합니다. 세션이 끝난 뒤 돌아오면 FiboCode가 그 사이 수정된 모든 파일을 집계해 changed files card에 표시합니다. 에이전트가 실제로 무엇을 했는지 기억이나 git status로 다시 구성할 필요가 없습니다.
  3. 빠르게 검토합니다. 카드에서 Review를 누르고 diff를 hunk별로 읽어 각 블록을 수락하거나 거절하거나 파일 전체를 한 번에 처리합니다. Snapshot으로 파일의 이전 상태로 되돌릴 수 있습니다.
  4. Commit합니다. Source Control을 열고 변경을 stage한 뒤 commit message를 생성하거나 작성하고 commit합니다.

사용법 2: 코드 분석과 이해

저장소를 읽는다는 것은 모든 파일을 처음부터 끝까지 여는 일이 아니라, 코드가 자신의 구조를 설명하도록 하는 일입니다.

  1. 범위와 템플릿을 구성합니다. System Config → Code Analysis로 이동합니다.
    • Directory Blacklist — 디렉터리 이름을 정확히 비교하며, 일치하는 디렉터리와 그 아래 모든 항목을 제외합니다(node_modules, dist, …).
    • Extension Whitelist — 코드 또는 구성 확장자 허용 목록과 일치하는 파일만 분석합니다.
    • Analysis Templates — Directory, Code File, Configuration File 템플릿을 각각 편집해 생성 설명의 구조를 정하며, 각 템플릿을 원래 내용으로 재설정할 수 있습니다.
  2. 분석을 시작합니다. workspace 패널로 돌아가 Analyze를 클릭해 저장소 전체 분석을 실행합니다. 디렉터리와 파일은 모델 구성의 동시성 설정 범위에서 병렬로 분석됩니다. 언제든 중단할 수 있고 완료되면 알림을 받습니다.
  3. 설명을 읽습니다. 디렉터리나 파일을 클릭하면 오른쪽 Document 보기에 설명이 표시됩니다. Graph 보기로 전환하면 해당 위치의 개념 그래프를 볼 수 있습니다. 디렉터리 수준 메모는 “이 계층은 무엇을 하는가”, 파일 수준 메모는 “이 파일은 어떻게 하는가”에 답합니다.
  4. 태그를 따라갑니다. 설명 안의 code / text / graph 태그는 클릭 가능한 앵커입니다. code는 소스 파일과 줄 범위로, text는 연결된 문서로, graph는 해당 개념 그래프로 이동합니다. 어디를 읽고 있든 코드와 설명 사이를 오갈 수 있습니다.

다음 단계