ai-sync: Instructions file for Claude Code

AGENTS.md

ai-sync AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from beixiyo/ai-sync. It costs 3,286 tokens per session, scanned B, original, MIT.

Project-specific instructions for ai-sync, a TypeScript command-line tool that moves AI configuration between coding tools. They describe its structure, supported settings, and command-line behavior.

In plain words
What is it for?
Use them when adding tool support, changing converters or migrators, updating configuration handling, or working on the CLI.
Why use it?
They help an agent make changes that fit the project’s architecture and preserve how configuration migration and command-line choices work.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: $ARGUMENTS substitution, but also the file is AGENTS.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

This is beixiyo/ai-sync's own configuration. It tells Claude Code, Codex and OpenCode how to work on ai-sync itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything ai-sync configures →

Reuse

Borrowing it

Nothing to install: this file belongs to beixiyo/ai-sync. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/beixiyo/ai-sync/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/beixiyo/ai-sync

Made for: Claude Code, Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ai-sync AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/beixiyo/ai-sync/agents-md/github.svg)](https://agentmods.dev/instructions/beixiyo/ai-sync/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/beixiyo/ai-sync/agents-md"><img src="https://agentmods.dev/badge/instructions/beixiyo/ai-sync/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ai-sync AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/beixiyo/ai-sync/agents-md"><img src="https://agentmods.dev/badge/instructions/beixiyo/ai-sync/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,286 This file is loaded in full into every session.
When invoked 3,286 The same file — it is already loaded in full.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.03286 $0.03286
Opus 5.5 $0.01314 $0.01314
Sonnet 5.5 $0.00657 $0.00657
Haiku 4.5 $0.00329 $0.00329

Measured 8d ago against content hash cd63566fdb1c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

ai-sync AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

`~/.gemini/settings.json`
AGENTS.md · 283 lines

How it starts

The opening of the file, as written. The whole thing — 283 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AI Agent 指南 - ai-sync 项目

本文档为在 ai-sync 项目上工作的 AI Agent 提供必要信息。遵循这些指南以确保一致性和质量

项目概览

ai-sync 是一个基于 TypeScript 的 CLI 工具,用于在不同 AI 工具(如 Cursor、Claude Code、OpenCode 等)之间迁移 AI 配置(Commands、Skills、Rules、MCP)

  • 技术栈: TypeScript、Node.js (ESM)、pnpm、Vitest、ESLint (Antfu 配置)、tsup
  • 核心逻辑: 位于 src/lib/,包含迁移器和转换器

文件结构

  • src/index.ts: CLI 入口点
  • src/lib/configs/: 工具特定配置
  • src/lib/converters/: 数据格式转换逻辑(例如 Markdown 到 TOML)
  • src/lib/migrators/: 每个工具的高级迁移逻辑
  • src/lib/utils/: 共享工具函数(文件 I/O、Logger 等)
  • tests/: Vitest 测试套件

特殊说明

  • 添加新工具支持时,更新 src/lib/configs/ 并实现必要的迁移器/转换器
  • 参考 docs/sync-rules.md 了解特定工具配置路径和转换逻辑
  • 遵守 eslint.config.mjs 设置,特别是 forceTernary 和 docComment 规则
  • 如果在代码中发现 // @TODO 或 // FIXME,在任务范围内解决它们

CLI 交互规则

  • 支持交互式选择和命令行参数两种模式
  • 无参数时进入完全交互式选择
  • 有参数时快速执行,跳过交互
  • 工具选择支持多选,逗号分隔
  • 支持 -s 指定源目录、-t 指定目标工具、-y 自动覆盖等参数

配置加载规则

  • 自动查找家目录或指定目录中的 ai-sync.config.js 配置文件
  • 支持 CommonJS 和 ESM 格式
  • 支持 package.json 中的 ai-sync 字段配置
  • 自定义配置与默认配置合并,自定义配置优先级更高

Rules 优先级规则

同步时按以下顺序优先选择规则源: ~.claude/{CLAUDE.md,AGENTS.md}

注意:不再向 Cursor 迁移 Rules,因为 Cursor 已支持自动检测 ~/.claude/CLAUDE.md

Commands 转换总结对比

特性 Gemini CLI Cursor Claude Code CodeBuddy OpenCode Codex CLI
文件格式 TOML Markdown Markdown Markdown Markdown / JSON TOML / YAML
项目位置 .gemini/commands/ .cursor/commands/ .claude/commands/ .codebuddy/commands/ .opencode/commands/ .codex/prompts/
全局位置 ~/.gemini/commands ~/.cursor/commands/ ~/.claude/commands/ ~/.codebuddy/commands/ ~/.config/opencode/commands/ ~/.codex/prompts/
参数语法 {{args}} 无特殊语法 $ARGUMENTS, $1, $2 $ARGUMENTS, $1, $2 $ARGUMENTS, $1, $2 $ARGUMENTS, $1, $2, 命名参数
Shell执行 !{command} 不支持 !command`` (需声明 allowed-tools) !command`` (需声明 allowed-tools) !command`` (无需声明) 配置文件白名单
文件引用 @{filepath} 不支持 @filename @filename @filename @filename
命名空间 子目录 子目录 子目录 子目录 子目录 子目录
Frontmatter 不支持 不支持 支持 支持 支持 支持

Read the full file on GitHub · 283 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago Changed · +11 tokens per session cd63566fdb1c
  2. 16d ago Changed · +10 lines · +214 tokens per session f8fd41a5f83d
  3. 28d ago Changed · +99 tokens per session d7cae7102b93
  4. 1mo ago Changed · +13 lines · +380 tokens per session 45312f9e9ab4
  5. 1mo ago Changed · +30 lines · +420 tokens per session 9d321a0730c5
  6. 1mo ago First seen · 230 lines · 2,162 tokens per session scan B 8145cfd767c3

Subscribe to this mod's changes

ai-sync AGENTS.md is an instructions file published in the GitHub repository beixiyo/ai-sync (9 stars, last pushed 12d ago), licensed MIT. It adds 3,286 tokens to every session, about $0.0131 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens