moonproxy-desktop AGENTS.md

Project instructions for MoonProxy, a desktop app for configuring and running frpc, the client used to create network tunnels through an frp server. The app supports proxy rules, connection status, traffic monitoring, scheduling, tray operation, and updates.

In plain words
What is it for?
Use them when working on proxy configuration, frpc start and stop states, traffic displays, scheduled connections, system-tray behavior, or application updates.
Why use it?
They explain how the desktop interface, background process, stored settings, connection checks, and update paths fit together. This reduces mistakes when changing networking or startup behavior.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/moonproxyhq/moonproxy-desktop/agents-md
Clone the repo
git clone --depth 1 https://github.com/MoonProxyHQ/moonproxy-desktop

Made for: Codex, OpenCode.

Per session 3,883 This file is loaded in full into every session.
When invoked 3,883 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.03883 $0.03883
Opus 5 $0.01942 $0.01942
Sonnet 5 $0.00777 $0.00777
Haiku 4.5 $0.00388 $0.00388

Measured 2d ago against content hash 86e126670c66, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

moonproxy-desktop AGENTS.md scanned grade A with 0 findings 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 2d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 228 lines

How it starts

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

MoonProxy

跨平台、面向非技术用户的 frp 桌面客户端, 基于 Tauri v2 构建,支持 Windows 与 macOS。

用户视角的介绍请看 README.md;本文档面向在仓库里改代码的工程师。

功能

  • 用户填入自己的 frps 服务端(地址、端口、Token、用户名),或预置自定义服务商快速切换
  • 可视化管理代理规则(TCP / UDP / HTTP / HTTPS),主页实时显示本地端口连通性
  • 实时流量监控:主页上下行速率曲线、连接数与累计流量(内置 TCP 中转层计数)
  • 一键启动 / 停止 frpc:启动按钮分 4 态(已停止 / 连接中 / 已连接 / 连接错误), 连接状态由 frpc 自身证据支撑(/api/status 探测 + 30s 超时回退)
  • 系统托盘常驻:关闭窗口默认隐藏到托盘,frpc 继续后台运行
  • 开机启动 + 静默启动(自启时隐藏到托盘)
  • 开机自动连接(仅 OS 自启路径触发,手动启动不会误连)
  • 定时连接(按星期多选 + 起止时间,分钟对齐 + 启动补跑 + 热加载)
  • frpc 引擎自更新:GitHub Release → SHA256 校验 → 原子替换,无需重装应用
  • 应用本体自更新:基于 tauri-plugin-updater 的「重启并安装」
  • 通过 Tauri sidecar 机制内置 frpc 二进制,用户无需单独安装

技术栈

  • 前端:Vue 3 + TypeScript + Vite 6
  • 后端:Rust + Tauri v2
  • frpc 版本:v0.69.1(已内置;可通过 pnpm sync:frpc 同步其他平台)

目录结构

moonproxy-desktop/
├── src/                          # Vue 前端
│   ├── App.vue                   # 顶层壳:TitleBar + 视图路由 + 全局键盘 / 右键 + 事件订阅
│   ├── main.ts                   # 挂载入口(按 ?view= 区分主窗 / 日志窗)
│   ├── state/                    # 跨组件响应式状态(拆分到各文件)
│   │   ├── index.ts              # 统一导出
│   │   ├── runtime.ts            # 运行时:frpc 状态 / 日志 / 启动时间
│   │   ├── config.ts             # 服务商 / 代理配置
│   │   ├── prefs.ts              # 偏好:语言 / 启动项 / 定时
│   ├── styles.css                # HSL 设计令牌 + 通用组件类
│   ├── composables/              # 按主题拆分的可复用状态 / 命令
│   │   ├── useToast.ts
│   │   ├── useFrpcUpdate.ts      # frpc 引擎自更新
│   │   ├── useAppUpdate.ts       # 应用本体自更新
│   │   ├── useProxyHealth.ts     # 主页端点健康点 + 指数退避轮询(3→6→12→24s)
│   │   ├── useTraffic.ts         # 实时流量:累计 / 滚动窗口 / 瞬时速率
│   │   └── useAppEvents.ts       # 应用级事件订阅 + 启动初始化
│   ├── components/
│   │   ├── TitleBar.vue          # 跨平台标题栏
│   │   ├── BrandIcon.vue         # 单色品牌标识
│   │   ├── CloseConfirm.vue      # frpc 运行时的关闭确认弹窗
│   │   ├── Toast.vue             # 顶部 Toast 渲染
│   │   ├── home/                 # HomeView 子组件(启动按钮 / 流量图表 / 端点列表 …)
│   │   └── settings/             # 设置面板 Tab 子组件
│   │       ├── ProviderTab.vue   # 服务商
│   │       ├── ProxyTab.vue      # 代理规则
│   │       ├── InterfaceTab.vue  # 界面语言切换
│   │       ├── LaunchTab.vue     # 开机启动 / 静默启动 / 开机自动连接
│   │       ├── ScheduleSection.vue  # 定时连接(LaunchTab 内嵌)
│   │       ├── LogsTab.vue       # 运行日志
│   │       └── AboutTab.vue      # 关于(含软件更新 + 核心引擎)
│   └── views/
│       ├── HomeView.vue          # 主面板:流量图表 / 启动按钮 / 端点列表 / 引导卡片
│       ├── ServicesView.vue      # 「服务」视图:复用 ProviderTab + ProxyTab
│       └── SettingsView.vue      # 设置面板:分段控件 + Tab 切换
├── src-tauri/
│   ├── src/
│   │   ├── main.rs               # Windows release 抑制控制台
│   │   ├── lib.rs                # Tauri Builder 配置 + setup hook + invoke_handler + ExitRequested 兜底
│   │   ├── types.rs              # 共享类型:StartArgs / ProxyConfig
│   │   ├── config.rs             # frpc.toml 生成 + 客户端配置持久化
│   │   ├── process.rs            # frpc 子进程生命周期
│   │   ├── frpc_state.rs         # 连接状态机 + 日志环形缓冲
│   │   ├── proxy_health.rs       # 代理本地端口连通性探测
│   │   ├── proxy_relay.rs        # frpc↔本地服务 TCP 中转层 + 流量统计
│   │   ├── latency.rs            # 服务端 TCP 握手延迟探测
│   │   ├── frpc_update.rs        # frpc 自更新
│   │   ├── prefs.rs              # 应用偏好
│   │   ├── scheduler.rs          # 按星期定时启停 frpc
│   │   ├── tray.rs               # 系统托盘
│   │   └── assets/               # 编译期嵌入资源(托盘图标)
│   ├── binaries/                 # frpc sidecar 二进制(按平台目标命名;不入库,本地放置)
│   ├── capabilities/
│   │   ├── default.json          # 主窗权限
│   │   └── logs.json             # 独立日志窗权限
│   ├── tauri.conf.json           # 窗口 400×740、无装饰、sidecar 声明、updater 端点
│   └── tauri.macos.conf.json     # macOS 平台覆盖:系统交通灯 + Overlay + hiddenTitle
├── docs/app-icons/               # 图标设计源(APP Icon + 托盘图标),含 README 规范
└── scripts/                      # 仓库辅助脚本
    ├── sync-frpc.sh              # 按 .env 版本同步 frpc 二进制到 src-tauri/binaries/
    └── check-icons.py            # 图标规范校验(更新图标后必跑)

Read the full file on GitHub · 228 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. 2d ago First seen · 228 lines · 3,883 tokens per session scan A 86e126670c66

Subscribe to this mod's changes

moonproxy-desktop AGENTS.md is an instructions file published in the GitHub repository MoonProxyHQ/moonproxy-desktop (58 stars, last pushed 2d ago), licensed MIT. It adds 3,883 tokens to every session, about $0.0194 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

Codex-App-Manager CLAUDE.md

Instructions for Wangnov/Codex-App-Manager, covering claude.md — agent 作业指南, 质量门与合并, 发版流程(tag 驱动) and website/ 子工程(官网,codexapp.agentsmirror.com).

Wangnov/Codex-App-Manager · 1,026 tokens

DeepSeek-Harness-Desktop AGENTS.md

Instructions for web-casa/DeepSeek-Harness-Desktop, covering agents.md — dsh desktop, 项目本质, 不可违背的安全不变量, 版本单一事实源(改动版本时必须同时改全部) and harness 升级启动契约(bump pin 前必读).

web-casa/DeepSeek-Harness-Desktop · 2,781 tokens

unity-cross-platform-local-build-orchestrator AGENTS.md

Instructions for sinanata/unity-cross-platform-local-build-orchestrator, covering agents.md, what this project is, golden rules (do not violate), use it and interface.

sinanata/unity-cross-platform-local-build-orchestrator · 2,557 tokens

fyagent AGENTS.md

AGENTS.md instructions for fy-agent/fyagent: These instructions are for AI assistants working in this project.

fy-agent/fyagent · 251 tokens

workhub CLAUDE.md

Instructions for atman-33/workhub, covering workhub, commands, in src-tauri/, architecture and data model: the vault is the source of truth.

atman-33/workhub · 1,462 tokens

unity-cross-platform-local-build-orchestrator copilot-instructions.md

Instructions for sinanata/unity-cross-platform-local-build-orchestrator: This repository follows the cross-tool AGENTS.md standard. Read /AGENTS.md for the full guide: the script/CLI interface, the config workflow, and the operating rules.

sinanata/unity-cross-platform-local-build-orchestrator · 463 tokens