fy-agent/fyagent

FyAgent – A Personal AI‑Agent Control Center

What it is – FyAgent (short for For You Agent) is a cross‑platform desktop application (Windows & macOS) that lets you manage the configuration of the various AI‑powered tools you already use. It gathers together the pieces that normally live in separate places – the model/provider you want to run, the skills/plugins you’ve installed, the prompt templates you rely on, and the credentials for external services – and presents them in a single, locally‑stored UI.

Why it matters – As AI assistants, code‑generation agents, and “AI Workers” proliferate, users end up juggling many different configuration files, API keys, and model selections. FyAgent makes those hidden choices visible, editable, and portable, reducing the risk of mis‑configuration and giving you a consistent way to switch models or add new capabilities across all supported tools.

---

Core functionality (as described in the README)

Area	What you can do
AI Software Configuration	Scan for installed AI‑related applications (e.g., QoderWork CN, TRAE Work CN, WorkBuddy, Grok Build, Codex, Claude Code, OpenCode). From the UI you can install, update, launch, authenticate, and allocate resources for each supported app.
Model Management	View and edit the model and Provider (the model‑hosting service) used by each app. Changes are previewed before being written, and the app validates the result after saving.
Skills Management	Install “Skills” (plugins or tool integrations) from a local source or a discovery page and assign them to the supported applications.
MCP Management	Add, import, and manage MCP (presumably Model‑Control‑Plane or similar) services, then bind them to the apps that support them.
Prompt Management	Edit the prompt templates used by Grok Build, Codex, Claude Code, OpenCode, Gemini, OpenClaw and Hermes.
Memory Module	Edit long‑term memory files for OpenClaw and Hermes, and edit the daily memory file for OpenClaw.

All configuration data lives by default in ~/.fyagent on the local machine, with the README linking to detailed docs on backup and file locations.

---

Typical workflow

1. Install – Download the appropriate installer from the GitHub releases page (.dmg for macOS, .exe for Windows). The macOS build is signed and notarized; the Windows build is an NSIS installer.
2. Scan – Open the AI Software Configuration page; FyAgent automatically discovers the supported AI tools you have installed.
3. Configure – Pick a tool, then use the side‑panel to set the model/provider, attach Skills, select an MCP service, and edit prompt or memory files. A preview shows exactly what will change.
4. Apply – Save the changes; FyAgent runs a post‑save verification and, where possible, launches the target application or tests the connection.
5. Iterate – Return to the UI anytime you want to switch models, add a new Skill, or tweak prompts without digging into each tool’s individual config files.

---

Installation & development notes

• Prerequisites – For building from source you need the mise version manager (≥ 2026.8.6). The repo provides scripts (mise run bootstrap, mise run dev, mise run build, etc.) that set up the toolchain, run checks, and produce a platform‑specific binary.
• Release verification – Each release ships a checksum, a signing-status.json file, and a build‑proof document. Users are encouraged to verify these before installing.
• License – The code is source‑available but not OSI‑approved open source. FyAgent’s own components are under the PolyForm Non‑commercial License 1.0.0; third‑party code inherited from the CC Switch project remains under MIT. Commercial use requires a separate written permission.

---

Who might benefit?

• Developers and power users who run multiple AI coding assistants or chat agents and want a single place to switch models, update credentials, or add new plugins.
• Teams that need a reproducible, locally‑stored configuration for each workstation without relying on cloud‑only management solutions.
• Enthusiasts exploring emerging AI agents who want to experiment with different prompt templates, memory files, or skill sets across several tools.

---

Where to get help

• Discussions – Q&A, ideas, and “show‑and‑tell” threads are available under the repository’s Discussions section.
• Issues – Bug reports follow the provided template; the maintainers ask for version, OS, and steps to reproduce.
• Documentation – Full user manuals exist in Chinese, English, and Japanese, covering installation, configuration files, FAQ, and development guidelines.

---

Bottom line

FyAgent is a genuine, actively‑maintained desktop utility that centralises the otherwise fragmented configuration of a growing ecosystem of AI‑powered developer tools. It does not perform inference or training itself, but it streamlines how you connect to and control the models, prompts, and extensions that power those tools.