fy-agent/fyagent

For You Agent——AI 时代的个人随身数字人格。把你的模型、AI 账号、技能、提示词和工作方式，带到每一个 AI 工具里。

FyAgent – 개인용 AI 에이전트 제어 센터

무엇인가요 – FyAgent(For You Agent의 약자)는 크로스플랫폼 데스크톱 애플리케이션(Windows & macOS)으로, 이미 사용 중인 다양한 AI 도구의 설정을 관리할 수 있게 해줍니다. 일반적으로 별도의 장소에 분산되어 있는 요소들—사용할 모델/프로바이더, 설치한 스킬/플러그인, 의존하는 프롬프트 템플릿, 외부 서비스 인증 정보—를 하나의 로컬 UI에 통합하여 제시합니다.

왜 중요한가요 – AI 어시스턴트, 코드 생성 에이전트, "AI 워커"가 증가함에 따라 사용자는 여러 설정 파일, API 키, 모델 선택을 관리해야 합니다. FyAgent는 이러한 숨겨진 선택을 시각화하고 편집 가능하게 하며, 이동 가능하게 만들어 잘못된 설정의 위험을 줄이고, 모든 지원되는 도구에서 모델 전환 또는 새로운 기능 추가를 일관된 방식으로 수행할 수 있게 해줍니다.

핵심 기능 (README에 설명됨)

영역	수행 가능한 작업
AI 소프트웨어 설정	설치된 AI 관련 애플리케이션(예: QoderWork CN, TRAE Work CN, WorkBuddy, Grok Build, Codex, Claude Code, OpenCode)을 스캔합니다. UI에서 각 지원 앱의 설치, 업데이트, 실행, 인증, 리소스 할당이 가능합니다.
모델 관리	각 앱에서 사용하는 모델과 프로바이더(모델 호스팅 서비스)를 보고 편집합니다. 변경 사항은 저장 전 미리 보기로 확인되며, 저장 후 앱이 결과를 검증합니다.
스킬 관리	로컬 소스 또는 디스커버리 페이지에서 "스킬"(플러그인 또는 도구 통합)을 설치하고, 지원 앱에 할당합니다.
MCP 관리	MCP(일반적으로 Model-Control-Plane 또는 유사한 것) 서비스를 추가, 가져오기, 관리한 후, 지원하는 앱에 바인딩합니다.
프롬프트 관리	Grok Build, Codex, Claude Code, OpenCode, Gemini, OpenClaw, Hermes에서 사용하는 프롬프트 템플릿을 편집합니다.
메모리 모듈	OpenClaw 및 Hermes의 장기 메모리 파일을 편집하고, OpenClaw의 일일 메모리 파일도 편집할 수 있습니다.

모든 설정 데이터는 기본적으로 로컬 머신의 ~/.fyagent에 저장되며, README는 백업 및 파일 위치에 대한 자세한 문서 링크를 제공합니다.

일반적인 워크플로우

설치 – GitHub 릴리스 페이지에서 적절한 설치 파일을 다운로드합니다(.dmg for macOS, .exe for Windows). macOS 빌드는 서명 및 노트리제이션 완료, Windows 빌드는 NSIS 설치 프로그램입니다.
스캔 – AI 소프트웨어 설정 페이지를 열면 FyAgent가 설치된 지원 AI 도구를 자동으로 탐지합니다.
설정 – 도구를 선택한 후 사이드패널에서 모델/프로바이더 설정, 스킬 연결, MCP 서비스 선택, 프롬프트 또는 메모리 파일 편집을 수행합니다. 미리보기는 정확히 어떤 변경이 일어날지 보여줍니다.
적용 – 변경 사항을 저장하면 FyAgent는 저장 후 검증을 수행하고, 가능하면 대상 앱을 실행하거나 연결을 테스트합니다.
반복 – 언제든지 UI로 돌아와 모델 전환, 새로운 스킬 추가, 프롬프트 조정을 각 도구의 개별 설정 파일을 뒤지지 않고도 수행할 수 있습니다.

설치 및 개발 참고사항

사전 요구 사항 – 소스에서 빌드하려면 mise 버전 관리자(≥ 2026.8.6)가 필요합니다. 리포지토리는 mise run bootstrap, mise run dev, mise run build 등의 스크립트를 제공하여 툴체인 설정, 검사 실행, 플랫폼별 바이너리 생성을 자동화합니다.
릴리스 검증 – 각 릴리스에는 체크섬, signing-status.json 파일, 빌드 증명서가 포함됩니다. 설치 전 검증을 권장합니다.
라이선스 – 코드는 소스 공개이지만 OSI 승인 오픈소스는 아닙니다. FyAgent 자체 컴포넌트는 PolyForm Non-commercial License 1.0.0 하에 있으며, CC Switch 프로젝트에서 상속된 제3자 코드는 MIT 라이선스를 유지합니다. 상용 사용은 별도 서면 허가가 필요합니다.

누가 이득을 볼 수 있나요?

여러 AI 코딩 어시스턴트나 채팅 에이전트를 운영하며, 모델 전환, 자격 증명 업데이트, 새로운 플러그인 추가를 한 곳에서 원하는 개발자 및 고급 사용자.
클라우드 전용 관리 솔루션에 의존하지 않고, 각 워크스테이션에 재현 가능한 로컬 저장 설정을 유지해야 하는 팀.
새로운 AI 에이전트를 탐색하며 여러 도구에서 다른 프롬프트 템플릿, 메모리 파일, 스킬 세트를 실험하고 싶은 열정적인 사용자.

도움 받는 곳

디스커션 – 리포지토리의 Discussions 섹션에서 Q&A, 아이디어, "보여주기" 스레드를 찾을 수 있습니다.
이슈 – 버그 보고는 제공된 템플릿을 따르며, 버전, OS, 재현 단계를 요청합니다.
문서 – 설치, 설정 파일, FAQ, 개발 가이드라인을 포함한 완전한 사용자 매뉴얼은 중국어, 영어, 일본어로 제공됩니다.

결론

FyAgent는 성장하는 AI 기반 개발 도구 생태계에서 분산된 설정을 통합하는 진정한, 활발히 유지 관리되는 데스크톱 유틸리티입니다. 자체적으로 추론이나 학습을 수행하지는 않지만, 이러한 도구를 구동하는 모델, 프롬프트, 확장 기능에 연결하고 제어하는 방식을 간소화합니다.