KingFolder — Your AI's Home
KingFolder is a special folder inside your project that KingDesk creates and manages automatically. It lives at zx_KingFolder/ in your project root and is the single place where your AI stores everything it learns about your project.
Think of it as your AI's desk — rules, history, configs, and plans all go here.
Save a file in KingFolder on your laptop. Open KingDesk on your office PC. It's already there. KingSync handles the rest automatically — no manual upload, no git push needed.
Inside KingFolder
KingFolder contains several special sub-folders, each with a specific purpose.
| Folder | What it holds |
|---|---|
_Policy/ | Rules your AI must follow in this project — coding conventions, team practices, things to never do |
_Infra_Config/ | Environment settings, server addresses, API keys, deployment configs |
__MacFlow/ | AI conversation records, decisions made, work plans, todo lists |
__Private/ | Your private notes — visible only to you, not to collaborators |
_Urgent/ | Critical reports your AI files when it finds a policy gap or a blocker |
What You Do vs. What KingDesk Does
You don't have to manage most of this. KingDesk and your AI handle the bookkeeping.
| Your job | KingDesk's job |
|---|---|
| Work in your project normally | Create and maintain zx_KingFolder/ |
Write rules in _Policy/ when you want them remembered | Inject those rules into every AI session automatically |
Store .env files in _Infra_Config/ | Back up environment files when they change |
| Ask your AI anything | Read _Policy/ and _Infra_Config/ at the start of each session |
KingSync — Always in Sync
KingSync is the engine that keeps your KingFolder identical across all your devices and your team.
It works like Dropbox: write a file locally, and it uploads to the server. A teammate changes something, and it comes down to you.
What syncs automatically:
- All markdown documents, notes, and plans
- Policy files and environment configs
- AI conversation records
What never syncs:
- Hidden files (
.prefix) - Executable files (
.exe,.dll, etc.) - Conflict copies (created automatically when two edits clash)
When a conflict happens, KingSync keeps your local version and saves the server version as a .conflict.{timestamp} file so nothing is lost.
Collaborator Folders
When a teammate joins your project, they get their own KingFolder — zy_Coworker_Name/ — at the project root. Their folder is separate from yours.
zx_prefix = owner (you)zy_prefix = collaborator
Your AI can read collaborator policy files. Their AI can read yours. The team stays aligned without any manual sharing.