neeko AGENTS.md

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

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/tincopper/neeko/agents-md
Clone the repo
git clone --depth 1 https://github.com/tincopper/neeko

Made for: Codex, OpenCode.

Per session 7,575 This file is loaded in full into every session.
When invoked 7,575 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.07575 $0.07575
Opus 5 $0.03787 $0.03787
Sonnet 5 $0.01515 $0.01515
Haiku 4.5 $0.00758 $0.00758

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

Security

Grade A, and why

neeko 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 3d 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 · 533 lines

How it starts

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

Neeko — Repository Guidelines

AI 编程助手项目上下文与开发规范。此文件是所有 AI Agent 的单一事实源(Single Source of Truth)。

项目概览

Neeko 是一个基于 Tauri 2.0 + React 18 的桌面应用,统一管理多项目 AI Agent 会话。支持三种项目类型。

  1. 本地项目
  2. WSL 项目
  3. SSH 远程项目

核心目标是将终端会话、Git 操作、文件变更、IDE 启动与 Skill 管理聚合到同一窗口,并保持会话可恢复。

  • 版本: 1.0.4
  • 标识符: com.neeko.app
  • 许可证: Apache 2.0
  • 包管理器: pnpm 9.12.2
  • Node: 24+
  • Rust edition: 2021
  • 前端端口: 1420(与 tauri.conf.jsondevUrl 对齐)

目录结构

前端(Feature-Based 架构)

src/
├── app/                              # 应用入口
│   ├── App.tsx                       # 组合层:hooks + JSX 编排
│   ├── main.tsx                      # 入口点
│   ├── AppModals.tsx, AppProviders.tsx
│   ├── components/                   # 应用级组件(SplashScreen 等)
│   ├── hooks/
│   │   ├── useAppShell.ts            # 主协调 hook
│   │   └── index.ts
│   └── dock/                         # Dock 布局组件
├── features/                         # 21 个功能域模块
│   ├── action-menu/ agent/ browser/ connection/ conversation/
│   ├── debug/ editor/ file/ git/ lsp/ notification/
│   ├── project/ quick-open/ session/ settings/ skill/
│   ├── status-bar/ symbol-nav/ task/ terminal/ theme/
│   └── (每个域有自己的 components/ hooks/ store/)
├── shared/                           # 跨域共享
│   ├── components/                   # 共享 UI 组件
│   ├── contexts/                     # React contexts
│   ├── dock/                         # Dock 系统
│   ├── hooks/                        # 共享 hooks
│   │   ├── useToast.ts, useKeyboardShortcuts.ts
│   │   ├── useProjectActions.ts, useSplitLayout.ts
│   │   └── ...
│   ├── store/                        # zustand 状态管理
│   │   ├── projectStore.ts, gitStore.ts, connectionStore.ts
│   │   ├── editorStore.ts, browserStore.ts, dockStore.ts
│   │   ├── lspStore.ts, notificationStore.ts, taskStore.ts
│   │   └── ...
│   ├── types/                        # 全局 TypeScript 类型(按域分文件)
│   │   ├── project.ts, git.ts, connection.ts
│   │   ├── terminal.ts, agent.ts, session.ts
│   │   ├── settings.ts, task.ts, skill.ts, editorGroup.ts
│   │   └── ...
│   └── utils/                        # 共享工具函数(27 个文件)
│       ├── terminal.ts, agents.ts, distros.ts
│       ├── fileIcons.ts, idePresets.ts, platform.ts
│       └── ...
├── layout/                           # 窗口布局框架
├── lib/                              # 工具库
├── ui/                               # 通用 UI 组件
├── styles/                           # 全局样式
└── testing/                          # 测试 setup
    └── setup.ts, factories.ts

Read the full file on GitHub · 533 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. 3d ago First seen · 533 lines · 7,575 tokens per session scan A 3f028cad4338

Subscribe to this mod's changes

neeko AGENTS.md is an instructions file published in the GitHub repository tincopper/neeko (10 stars, last pushed 4d ago), licensed Apache-2.0. It adds 7,575 tokens to every session, about $0.0379 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-31.