Vibe-Research: Instructions file for Codex

AGENTS.md

Vibe-Research AGENTS.md is an instructions file for Codex, OpenCode from simonlin1212/Vibe-Research. It costs 4,452 tokens per session, scanned A, original, MIT.

A set of rules for an A-share stock research agent, covering how it gathers data, calculates figures, evaluates companies, and presents conclusions.

In plain words
What is it for?
Use it to structure Chinese stock research, verify financial evidence, assess business quality, compare scenarios, and identify what new data could change the conclusion.
Why use it?
It prevents the agent from inventing financial numbers, doing calculations by hand, or giving trading instructions. It also requires facts, calculations, and interpretations to be kept separate.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions Claude Code; mentions Codex.

This is simonlin1212/Vibe-Research's own configuration. It tells Codex and OpenCode how to work on Vibe-Research 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 Vibe-Research configures →

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is cd ../desktop && npm test && npm run build.

About the project

Vibe Research is a local financial research workspace in which an AI agent gathers market data, performs multi-step analysis, and preserves reports, evidence, calculations, and research history. It is for investment research across Chinese, US, and Hong Kong stocks, including market reviews, company studies, portfolios, debates, and backtesting. The catalogue contains skills and an instruction for working with this research agent.

simonlin1212/Vibe-Research · 3,504 stars · on GitHub · viberesearch.wiki

Reuse

Borrowing it

Nothing to install: this file belongs to simonlin1212/Vibe-Research. 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/simonlin1212/Vibe-Research/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/simonlin1212/Vibe-Research

Made for: 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 Vibe-Research AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/simonlin1212/vibe-research/agents-md/github.svg)](https://agentmods.dev/instructions/simonlin1212/vibe-research/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/simonlin1212/vibe-research/agents-md"><img src="https://agentmods.dev/badge/instructions/simonlin1212/vibe-research/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 Vibe-Research AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/simonlin1212/vibe-research/agents-md"><img src="https://agentmods.dev/badge/instructions/simonlin1212/vibe-research/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,452 This file is loaded in full into every session.
When invoked 4,452 The same file — it is already loaded in full.
Security scan A 0 findings. 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.04452 $0.04452
Opus 5.5 $0.01781 $0.01781
Sonnet 5.5 $0.00890 $0.00890
Haiku 4.5 $0.00445 $0.00445

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

Security

Grade A, and why

Vibe-Research 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 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.

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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 173 lines

How it starts

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

Vibe-Research — 给 Agent 的部署与开发指南

你是来帮使用者部署、使用或改造本仓库的 Agent(Claude Code、Codex、WorkBuddy / CodeBuddy、Muse 一类个人云端 Agent……)。动手前先读完这一页。

研究方法论不在这里。研究线程的最高纪律是 methodology/constitution.md(研究宪法), 研究 SOP 在 .agents/skills/,计算函数契约在 calc/SPEC.md。产品在每个研究阶段把它们放进提示词,对所有大脑一视同仁; 它们约束的是研究线程里的大脑,不是你在本仓库里的工作方式。

1. 这是什么

本地运行的 A 股个股研究工作台:浏览器页面 + 本机服务 + 六阶段研究编排器 + Python 取数层 + 确定性计算库(calc/)。 研究的「大脑」可以换,换了以后受控工具、方法论、校验与合规 gate 都是同一套:

大脑 接法 登录与凭据
Claude Code 本机 claude CLI 使用者本人在终端用 claude.ai 订阅登录(API key / Bedrock / Vertex 登录不算订阅);产品不读、不存、不复制登录文件
Codex 本机 codex CLI 使用者本人在终端 codex login 用 ChatGPT 账号登录(Codex 里配的 API key 登录不认);同上
WorkBuddy / CodeBuddy 本机 codebuddy CLI(独立 CLI 或 WorkBuddy 桌面版内置) 使用者本人在终端运行 codebuddy 登录独立 CLI(新版 WorkBuddy 桌面版的登录加密保存,产品借不到);同上
模型 API 任意 Chat Completions 兼容接口(模板见 providers/) 页面里填的 key 只存在浏览器 localStorage,随请求交给本机服务,不落盘;命令行研究从模板声明的环境变量读 key

研究线程里的大脑没有 Shell、没有网络、没有任意文件读写,只有 5 个受控工具:列文件、读文件、确定性计算、写阶段产物、写报告。 取数由编排器在每个阶段开始前执行完;大脑想收工时,产品先做收工检查,产物缺失或校验不过就把问题清单交回去接着修。

2. 帮使用者部署

环境:Node.js ≥ 22.18、Python ≥ 3.11(推荐 3.12)、git。

git clone https://github.com/simonlin1212/Vibe-Research.git
cd Vibe-Research
scripts/setup     # Windows:scripts\setup-windows.cmd
scripts/start     # Windows:scripts\start.cmd
  • scripts/setup 创建 .venv、安装依赖、生成产品私有层 .local/ 并跑体检;scripts/doctor 可单独再跑(--json 给机器读)。
  • scripts/start 同时拉起本机 API 与页面,健康检查通过后打开 http://127.0.0.1:5930。 默认端口(页面 5930、API 8765)被占用或被系统保留时自动换空闲端口并在终端说明,以终端打印的地址为准; 换了页面端口时,浏览器里存的模型 API 设置和对话记录按地址分开,要在新地址重新设置(终端会提醒;默认端口空出来后重启就回到原来的); 要固定端口用 --port / --api-port(Windows -Port / -ApiPort)或环境变量 VRA_UI_PORT / VRA_API_PORT,指定的端口不能用时直接报错。 启动时提示「已经有一个 Vibe Research 在运行」:让使用者直接打开那个地址,不要终止别的进程去抢端口。
  • 页面打开后到左侧栏最下方的「接入 AI」选大脑并做一次真实对话测试,测试通过才会保存。 本机 CLI 要先由使用者本人登录(claude / codex login / codebuddy);登录发生在使用者自己的终端和浏览器里,你不代填、不转存任何账号信息。
  • Windows 上 WorkBuddy 装在别的盘也会从「已安装的程序」登记或正在运行的 WorkBuddy 里自动找到; 仍显示「未安装」时:先打开 WorkBuddy 再点「重新检测」,或在「接入 AI」的 WorkBuddy 卡片里填它的安装文件夹, 或在启动前设环境变量 CODEBUDDY_BIN / CLAUDE_BIN / CODEX_BIN(设了就只认它)。
  • 所有私有数据(配置、运行产物、对话、台账、上传资料)都在 .local/,已被 git 忽略。不要把它提交、打包或发给任何第三方。
  • 使用者不想装 Node / Python / git 时,让他到 Releases 下载免安装包(Windows x64 / Apple 芯片 / Intel Mac),解压后双击 Start-VibeResearch; 数据在包文件夹的 .local/,升级 = 新版本解压到新文件夹再把 .local/ 整个复制过去。包由 .github/workflows/portable.yml 构建 (本机构建:node scripts/portable/build.mts;冒烟:node scripts/portable/smoke.mts <解压出来的目录>), 包里 Node / Python 的版本、下载地址和 SHA256 只写在 scripts/portable/runtimes.json,升级运行时只改这一个文件。
  • 页面每天查一次 GitHub 最新正式版本(只带版本号;没查成隔一小时再试);设环境变量 VRA_UPDATE_CHECK=0 完全不联网。

Read the full file on GitHub · 173 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 · +26 tokens per session 2dbbbb64f345
  2. 26d ago Changed · +6 lines · +302 tokens per session cb23f2d474b6
  3. 27d ago Changed · +11 lines · -698 tokens per session 327e92c301a5
  4. 1mo ago Changed · +2 lines · +102 tokens per session 6900edcfc570
  5. 1mo ago Changed · -1 lines · -22 tokens per session d285024abc81
  6. 2mo ago Changed · +7 lines · +273 tokens per session 5c9a049dc215
  7. 2mo ago First seen · 148 lines · 4,469 tokens per session scan A 3aa886e6e631

Subscribe to this mod's changes

Vibe-Research AGENTS.md is an instructions file published in the GitHub repository simonlin1212/Vibe-Research (3,504 stars, last pushed 8d ago), licensed MIT. It adds 4,452 tokens to every session, about $0.0178 per session on Opus 5.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

Vibe-Research AGENTS.md compared with instructions from other repositories

Vibe-Research AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
Vibe-Research AGENTS.mdsimonlin1212/Vibe-ResearchInstructions file3.5k8d agoMITA4,452Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode