neeko: Instructions file for Codex

AGENTS.md

neeko AGENTS.md is an instructions file for Codex, OpenCode from tincopper/neeko. It costs 4,753 tokens per session, scanned C, original, Apache-2.0.

A repository guide for Neeko, a desktop app that manages AI coding-agent sessions across local, WSL, and SSH projects. It documents the app's structure and development rules.

In plain words
What is it for?
Use it when changing Neeko's React, Tauri, or Rust code, especially within its feature-based frontend and domain-based backend modules.
Why use it?
It gives coding agents one shared source of project context, so they can follow the repository's conventions instead of guessing how the code is organised.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions subagents; mentions Claude Code; reads ~/.codex paths.

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

Reuse

Borrowing it

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

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 neeko AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/tincopper/neeko/agents-md"><img src="https://agentmods.dev/badge/instructions/tincopper/neeko/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,753 This file is loaded in full into every session.
When invoked 4,753 The same file — it is already loaded in full.
Security scan C 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.04753 $0.04753
Opus 5.5 $0.01901 $0.01901
Sonnet 5.5 $0.00951 $0.00951
Haiku 4.5 $0.00475 $0.00475

Measured yesterday against content hash 8917a2c06fc3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

neeko AGENTS.md scanned grade C 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 yesterday.

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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

完整流程与必须 `rm -rf node_modules/.vite` 的原因见
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.

Neeko — Repository Guidelines

AI 编程助手项目上下文与开发规范(跨栈部分)。

分层加载模型 —— 本文件只放「改任何目录都成立」的内容(跨栈契约、通用原则、红线索引)。 单侧专属规则按代码物理边界拆分:

  • src-tauri/AGENTS.md —— Rust 后端专属(该侧红线 + 命令层/并发/导入防火墙)
  • src/AGENTS.md —— React 前端专属(该侧红线 + 模块导入防火墙/React 性能/状态管理)

硬指令:动手改 src-tauri/** 或 src/** 前,必须先 Read 对应子目录的 AGENTS.md。 不要依赖工具自动注入 —— 各工具行为不同:opencode / Claude Code 只在 Read 工具打开该子树 文件时注入(@ 提及、IDE 打开均不触发);Codex 只拼接「仓库根 → 当前工作目录」路径上的 文件,从仓库根启动的会话不会加载嵌套文件。漏读 = 该侧全部红线整体失效(红线表的 摘要列只够让你停下正在违规的操作,判据与例外仍以落点文件为准)。

机制细节与事故复盘在 .trellis/spec/<层>/<主题>.md(按需 trellis-before-dev 载入)与 docs/。 每条红线全文只在一个 AGENTS.md 中出现(.trellis/spec/ 是机制详解层,另当别论), 本文件的索引表负责指向它(check_agents_md_size.py 校验体积、落点唯一与台账一致)。

项目概览

Neeko 是基于 Tauri 2.0 + React 18 的桌面应用,统一管理多项目 AI Agent 会话,支持本地 / WSL / SSH 远程三种项目类型。核心目标:把终端会话、Git 操作、文件变更、IDE 启动与 Skill 管理聚合到同一窗口, 并保持会话可恢复。

  • 版本 / 标识符:见 package.json 与 src-tauri/tauri.conf.json(不在此处复述,历史上曾滞后三个版本)
  • 许可证:Apache 2.0 · Rust edition:2021 · Node:>=24 · 包管理器:pnpm(版本取 package.json 的 packageManager 字段)
  • 前端端口:1420(tauri.conf.json 的 build.devUrl)

顶层目录

src/                 React 前端(Feature-Based)→ 规则见 src/AGENTS.md
src-tauri/           Rust 后端(Domain-Driven)→ 规则见 src-tauri/AGENTS.md
tools/guards/        护栏框架与注册表(清单 = `checks/` 目录本身,新增文件即生效)
packages/            独立发布的 npm 包(`dsh-neeko`)→ 见下方门禁豁免
docs/                架构、需求与设计文档
.trellis/            spec 知识库、任务、会话日志(Trellis 管理)

packages/ 下的包不纳入本地与 CI 门禁(所以根 lint / test / check 与 ledger/gates.json 都不覆盖它):它的门禁是发布时的 prepublishOnly(自带的 check / test / lint:package)。要纳入时, 在 tools/guards/ledger/gates.json 增一条声明并同步以下接线:根脚本 + CI job + .github/BRANCH_PROTECTION.md 的 required checks —— 只改一处会得到一条看起来存在、实际不触发的门。 声明与 CI/lefthook 接线的一致性由 check_gate_topology(A1/A3)机器校验;BRANCH_PROTECTION 的 required check 核对属批次 2。

红线适用范围:packages/** 是 Node 库(非 Tauri 后端),15 条红线全部 N/A; 仍须遵守架构基本原则、TDD 与自带 prepublishOnly。

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. yesterday Changed · -26 tokens per session 8917a2c06fc3
  2. 2d ago Changed · +3 lines · +53 tokens per session b6ecc25676a5
  3. 5d ago Changed · +7 lines · +192 tokens per session 3d4298822b5f
  4. 16d ago Changed · +41 tokens per session 23746bd61481
  5. 19d ago Changed · +2 lines · +62 tokens per session c64900432e90
  6. 20d ago Changed · +44 tokens per session 297e6d4e4a9b
  7. 27d ago Changed · +8 lines · +250 tokens per session aa2fd8147841
  8. 1mo ago Changed · -342 lines · -5,330 tokens per session 8a3294b4b836
  9. 1mo ago Changed · +15 lines · +1,166 tokens per session scan A → C f8215b017982
  10. 1mo ago First seen · 535 lines · 8,301 tokens per session scan A 2749e374d9da

Subscribe to this mod's changes

neeko AGENTS.md is an instructions file published in the GitHub repository tincopper/neeko (12 stars, last pushed yesterday), licensed Apache-2.0. It adds 4,753 tokens to every session, about $0.0190 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). 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