fyagent README

The project's README from github.com/fy-agent/fyagent. As one markdown file: README.md.

FyAgent For You Gate

FyAgent

For You Agent——AI 时代的个人随身数字人格。

把你的模型、AI 账号、技能、提示词和工作方式，带到每一个 AI 工具里。

English · 日本語

Latest release CI status Windows and macOS Source-available license

下载最新版 · 使用手册 · 讨论区 · 参与贡献

AI 时代的个人智能控制中心

FyAgent 面向正在使用 AI Agent、AI Worker 和智能助手的人。它把模型从哪里来、能连接哪些工具、会哪些技能、遵循什么指令、保存怎样的配置，集中到一个本地桌面应用里。

你不需要先弄懂 Provider、MCP 或 Prompt 这些术语。对用户来说，它们分别是 AI 的大脑来源、工具连接和行为指令。FyAgent 要做的，是把原本散落、隐蔽、容易改错的选择变得可见、可改，也能跟着你走。

发布状态： FyAgent 仍在持续开发。升级前请备份重要配置，并在安装前阅读当次发布的可信度说明。

当前功能

区域 可以做什么
AI 软件配置 扫描 QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code 和 OpenCode；在支持时提供安装、更新、启动、认证和资源分配入口
运行状态 检查软件安装、配置和连接状态，并进入对应的处理入口
账号与认证 添加官方账号、管理软件连接，并选择 Codex 请求来源
模型管理 为上述软件查看或修改模型与 Provider 设置；写入前预览变更，并在保存后检查结果
Skills 管理 从本地或发现页安装 Skills，并分配给支持的软件
MCP 管理 添加、导入和管理 MCP 服务，并分配给支持的软件
提示词管理 管理 Grok Build、Codex、Claude Code、OpenCode、Gemini、OpenClaw 和 Hermes 的提示词
记忆模块 编辑 OpenClaw 与 Hermes 的长期记忆文件，以及 OpenClaw 的每日记忆

工作数据默认保存在本机 ~/.fyagent。具体写入位置、备份方法和各软件的支持差异见使用手册。

界面预览

以下截图使用简体中文。左侧导航提供软件配置、运行状态、账号、模型、Skills、MCP、提示词和记忆入口。

FyAgent Skills 管理页
Skills 		FyAgent 模型管理页
模型管理
FyAgent AI 软件配置页
AI 软件配置

快速开始

  1. 从 GitHub Releases 下载适合当前系统的安装包。
  2. 打开“AI 软件配置”，扫描本机已安装的软件。
  3. 选择一个软件并进入配置页。根据页面提供的入口设置模型、Skills、MCP、提示词或认证。
  4. 保存前检查预览中的修改范围；保存后按页面提示确认配置或测试连接。

完整步骤见简体中文手册，也提供 English 和 日本語。

下载与发布验证

发布文件名如下：

Windows 当前提供 NSIS 安装程序，不提供 MSI 或便携 ZIP。macOS 构建使用 Apple Developer ID 签名，并经过 Apple 公证。

安装前请阅读发布说明，并核对校验和、signing-status.json 和构建证明。NotSigned 只表示签名状态，不能单独证明文件安全。各系统的步骤见安装说明，版本记录见发布说明索引。

常见问题

FyAgent 会把数据保存在哪里？

默认保存在本机 ~/.fyagent。具体配置位置和备份方法见配置文件说明。

遇到安装或配置问题，应该去哪里提问？

先查看常见问题手册，再到 Q&A 讨论区说明 FyAgent 版本、操作系统、相关软件和已经尝试过的步骤。可稳定复现的软件缺陷请提交 Bug Report。

FyAgent 是开源软件吗？

FyAgent 是源码可用软件，不是 OSI 定义的开源软件。FyAgent 自有组件和修改采用 PolyForm Noncommercial License 1.0.0；继承自 CC Switch 的部分继续使用 MIT 许可证。详见授权说明。

社区与贡献

社区行为准则、支持范围和贡献流程见 CODE_OF_CONDUCT.md、SUPPORT.md 与 CONTRIBUTING.md。

本地开发

首次 checkout 需要全局安装 mise >= 2026.8.6：

mise trust
mise run bootstrap
mise run system:check
mise run dev

构建当前系统版本：

mise run build

提交前运行 mise run check。完整工具链、分层检查和发布要求见开发文档。

Star History

FyAgent Star History

项目来源与授权

FyAgent 的前身 VibeKey 是一个实体键盘与配套驱动的产品构想。项目后来转为跨平台桌面软件，重点改为 AI 软件配置与本地数据管理，并更名为 FyAgent（For You Agent）。

当前桌面应用基于 CC Switch 演进，并保留继承代码的原作者版权和许可证声明。FyAgent 自有组件和修改采用 PolyForm Noncommercial License 1.0.0，商业使用须另行取得书面授权。详见 LICENSE、LICENSING.md 和 THIRD_PARTY_NOTICES.md。

fyagent (fy-agent/fyagent)

Searching Database…

700 ·GitHub
Fyagent
这是什么？FyAgent 是一个本地桌面应用，充当 AI 智能体的个人控制中心：它把你的模型来自哪里、能连接哪些工具、拥有哪些 skill、遵循哪些提示词和记忆集中管理，然后让这套配置在你使用的每一个 AI 工具中保持一致。
这是独立应用，还是作为后台服务运行？它是一个用 Tauri 和 Rust 构建的原生跨平台桌面应用；你所有的配置数据和逻辑都在本地机器上运行，而不是在服务器上。
怎么把它跑起来？从 GitHub Releases 下载适合你操作系统的安装程序，打开「AI Software Configuration」扫描机器上已安装的 AI 工具，然后选择其中一个，配置它的模型、Skills、MCP、提示词或认证。
FyAgent 实际管理哪些 AI 工具？它可以扫描并配置 QoderWork CN、TRAE Work CN、WorkBuddy、Grok Build、Codex、Claude Code 和 OpenCode，还管理 Gemini、OpenClaw 和 Hermes 的提示词或记忆。
安装上有什么坑或不够完善的地方吗？FyAgent 仍在积极开发中，升级前你应该备份重要配置；在 Windows 上目前只提供 NSIS 安装程序，没有 MSI 或便携 ZIP 版本。
有 Linux 版本吗，还是只有 macOS 和 Windows？发布版本只提供 macOS（已签名并公证的 .dmg）和 Windows（x64 和 arm64 的 NSIS 安装文件）；没有提到 Linux 版本。
我的配置数据实际存储在哪里？工作数据默认存储在你自己机器上的本地文件夹中，而不是远程服务器。
Skills 管理功能能做什么？你可以从本地文件或发现页面安装 Skills，然后把它们分配给任何受支持的 AI 工具。
记忆模块让我能编辑什么？它让你能编辑 OpenClaw 和 Hermes 的长期记忆文件，以及 OpenClaw 的每日记忆日志。
它为什么叫 FyAgent？之前是什么？FyAgent 最初叫 VibeKey，是一个带配套驱动软件的实体键盘概念；后来转型为一款专注于 AI 工具配置和本地数据管理的跨平台桌面应用，并更名为 FyAgent（For You Agent）。
我可以把 FyAgent 用于商业用途吗？没有额外许可不行：FyAgent 自身的组件采用 PolyForm Noncommercial 许可，因此商业用途需要单独获得书面授权。
What are similar projects?ai-manager, golutra, Baize, CowAgent, Codex-X, cc-switch, codex-host, Orbital
Which topics is it in?personal-ai, config, ai-assistant, configuration, ai-tools, tauri, openclaw, memory, model-context-protocol, agents, desktop, agent-skills
Creator
fy-agent
Size
140.5 MB
Stars
700
Updated
CommitOct 15Releasev0.4.10Sep 30
Age
2mo
Commits · 90 Days