fcontext
lijma · 코딩 · 생산성
fcontext는 AI 코딩 에이전트를 세션과 도구, 팀원을 넘나들며 같은 상태로 유지하는 명령줄 컨텍스트 관리 시스템이다. 프로젝트 지식을 로컬 `.fcontext/` 폴더에 저장하고, PDF와 DOCX 같은 문서를 읽을 수 있는 Markdown으로 변환하며, GitHub Copilot과 Claude Code, Cursor 같은 에이전트가 작업을 시작하기 전에 그 폴더를 읽도록 가르친다. 목표는 단순하다. 반복 설명은 줄고, 결과는 더 일관되며, 새 채팅마다 낭비되는 컨텍스트는 줄어든다. AI 에이전트용 컨텍스트 관리 도구로서 빠르게 제 몫을 한다.
fcontext 소개
fcontext란 무엇인가
fcontext는 특정한 골칫거리를 해결하려고 만든 오픈소스 Python 도구다. AI 코딩 에이전트는 세션이 끝나는 순간 모든 것을 잊고, 한 에이전트에서 다른 에이전트로 바꾸면 칠판이 다시 지워진다. fcontext는 지원되는 모든 에이전트가 읽을 수 있는 단일 공유 프로젝트 컨텍스트 저장소를 유지해서 이 문제를 해결한다.
모든 것은 프로젝트 안의 .fcontext/ 디렉터리에 들어가므로 데이터는 로컬에 남는다. 클라우드 계정도, API 키도, 텔레메트리도 없다. 완전히 오프라인으로 실행할 수 있어서, 어디에도 업로드할 수 없는 비공개 코드베이스나 고객 문서를 다룰 때 특히 중요하다.
가장 큰 제약은 동시에 가장 큰 강점이다. fcontext는 CLI이므로 터미널에 익숙해야 하고, 명령으로 분명히 활성화한 에이전트만 돕는다. 어댑터가 없는 도구에 마법처럼 연결되지 않으며, 현재 지원하는 열두 개 에이전트 밖의 앱 컨텍스트는 관리하지 않는다.
시작하기
pip install fcontext로 패키지를 설치한다(Python 3.9 이상 필요).- 프로젝트 폴더에서
fcontext init을 실행해.fcontext/디렉터리를 만든다. - 예를 들어
fcontext enable copilot또는fcontext enable claude로 에이전트를 활성화해 네이티브 형식으로 지침을 받게 한다. fcontext index docs/로 문서를 인덱싱해 PDF와 DOCX, 스프레드시트를 에이전트가 읽는 Markdown으로 변환한다.fcontext status로 전체를 확인하고 다음 세션을 시작한다. 에이전트는 프로젝트 요약과 주제를 자동으로 읽는다.
제품 정보
fcontext의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 세션 사이에 컨텍스트를 잃는 1인 개발자
- 구성원끼리 작업을 넘기는 팀
- 여러 에이전트를 오가는 개발자
- 프라이버시를 중시하는 팀
작업
- 다음 날 디버깅 흐름을 이어가기
- 새 기여자 온보딩
- 바이너리 문서 다루기
- 요구사항 추적
활용 상황
- 속도보다 일관성이 중요한, 짧은 AI 세션이 여러 번으로 나뉜 장기 프로젝트.
- 요구사항은 문서에, 아키텍처 결정은 과거 대화에 존재하는 팀.
- 클라우드 기반 컨텍스트 도구가 선택지가 아닌 규제 또는 오프라인 환경.
주요 기능
세션 간·에이전트 간 기억
fcontext는 _README.md에 살아 있는 프로젝트 요약을 유지하고 세션 지식을 _topics/에 저장한다. 지원되는 모든 에이전트가 시작 전에 둘 다 읽으므로 컨텍스트는 대화 사이에서 살아남고 도구 사이를 넘나든다. Copilot에서 Claude로, 다시 Cursor로 바꿔도 프로젝트 그림은 그대로다.
네이티브 형식의 다중 에이전트 지원
명령 하나로 에이전트가 활성화되고, fcontext는 그 에이전트가 기대하는 형식으로 지침을 쓴다. Copilot은 .github/instructions/를, Claude는 .claude/rules/를, Codex는 AGENTS.md를, Zed는 .agents/skills/를 받는다. 열두 개 에이전트를 지원하며 모두 같은 기반 데이터를 공유한다.
문서를 Markdown으로 인덱싱
에이전트는 PDF나 Keynote 슬라이드를 스스로 읽지 못한다. fcontext는 PDF, DOCX, XLSX, PPTX, Keynote, EPUB 파일을 _cache/에 저장되는 Markdown으로 변환하므로, 에이전트는 추측 대신 당신의 명세를 직접 인용할 수 있다.
팀을 위한 경험 팩
한 프로젝트에서 얻은 지식을 다른 프로젝트로 옮길 수 있다. 팩을 zip이나 git URL, 다운로드 링크로 내보낸 뒤 fcontext experience import로 다른 곳에 가져온다. 새 팀원이 팩을 받으면 그 에이전트가 팀의 관례와 알려진 함정을 곧바로 공유한다.
이력을 갖춘 요구사항 관리
fcontext req 명령은 로드맵 항목, 에픽, 스토리, 작업, 버그를 다룬다. 트리 보기와 칸반 보드, 그리고 대체, 발전, 차단 같은 링크 유형을 얻는다. 에이전트는 CSV를 손으로 분석하는 대신 구조화된 요구사항을 읽으므로 잘못된 것을 만드는 일이 줄어든다.
로컬, 오프라인, 클라우드 없음
모든 데이터는 .fcontext/에 있고 코드와 함께 git으로 추적할 수 있다. 만들 계정도, 텔레메트리도, 네트워크 의존도 없으므로 에어갭된 머신에서도 작동하고 고객 자료를 당신의 하드웨어에 둔다.
장단점
장점
- Apache 2.0으로 무료이자 오픈소스이며, 핵심 기능을 붙잡는 유료 등급이 없다.
- 데이터가 `.fcontext/`에 로컬로 남아 프라이버시와 오프라인 작업이 문제되지 않는다.
- 인기 있는 코딩 에이전트 열두 개를 지원하고 각자의 네이티브 형식으로 설정을 쓴다.
- 문서 인덱싱이 PDF와 오피스 파일을 에이전트가 실제로 쓸 수 있는 텍스트로 바꾼다.
- 경험 팩이 팀 지식을 프로젝트와 사람 사이에서 옮길 수 있게 한다.
단점
- 명령줄 도구라서 터미널을 피하는 사람에게는 설정이 거칠게 느껴진다.
- 가치는 지원되는 에이전트를 쓸 때만 나오며, 지원되지 않는 도구는 아무 이득도 없다.
- 프로젝트마다 `fcontext init`과 `enable`을 실행해야 함을 기억해야 하는데, 짧은 스크립트에서는 잊기 쉽다.
- 프로젝트가 아직 어려서 요구사항 추적 같은 일부 흐름은 버전 사이에 바뀔 수 있다.
자주 묻는 질문
그렇다. fcontext는 Apache 2.0 라이선스로 공개되며 PyPI에서 비용 없이 설치된다. 유료 플랜도, 구독도, 업그레이드 뒤에 잠긴 기능도 없다.
관련 콘텐츠
fcontext와 관련된 도구, 스킬, 아티클을 살펴보세요.
fcontext 대안
Forefront
Forefront · 코딩Forefront는 오픈소스 AI로 무언가를 만드는 웹 플랫폼이다. 대표적인 오픈소스 언어 모델을 자신의 데이터로 미세 조정하고, 성능을 평가하고, API로 실행하거나 내보내 직접 호스팅할 수 있다. 폐쇄형 플랫폼의 편의를 원하면서도 모델과 데이터의 소유권은 놓지 않으려는 개발자가 대상이다.
Startkit
StartKit.AI · 코딩Startkit은 AI SaaS와 AI 래퍼 제품을 만들기 위한 보일러플레이트다. 지루한 부분을 미리 연결해 둔 AI 스타트업 보일러플레이트라고 생각하면 된다. 인증, Stripe와 Lemon Squeezy 결제, 사용량 제한, 트랜잭션 이메일, 그리고 OpenAI, Anthropic, Groq, Llama와 통신하는 AI API 스타터 키트가 포함된다. 저장소를 복제하고 가격을 정한 뒤 사용자가 실제로 돈을 내는 부분에 착수하면 된다. React와 Tailwind 위의 Next.js로 만들어졌기 때문에 보일러플레이트 코드의 상당 부분이 이미 익숙하게 느껴진다.
Testim
Tricentis · 코딩Testim은 웹, 모바일, Salesforce 애플리케이션 전반에 걸쳐 엔드투엔드 테스트를 만들고 실행하는 AI 기반 테스트 자동화 플랫폼이다. 머신러닝에 기대어 인터페이스가 바뀌어도 테스트를 안정적으로 유지하므로, 팀은 깨진 셀렉터를 고치는 데 쓰는 시간을 줄인다. 오늘부터 쓸 수 있는 자동화 테스트 도구치고 나쁘지 않다. 브라우저에서 동작을 녹화해 테스트를 만들고, 더 세밀한 제어가 필요하면 JavaScript를 더한다. 바쁜 QA 팀에게 탄탄한 선택이다.