ai-productivity-tracker: Instructions file for Codex

AGENTS.md

ai-productivity-tracker AGENTS.md is an instructions file for Codex, OpenCode from YoRHa1998/ai-productivity-tracker. It costs 6,127 tokens per session, scanned A, original, MIT.

Developer onboarding instructions for an AI productivity tracker that records coding conversations from tools such as Cursor and Claude Code and groups metrics by Jira work items.

In plain words
What is it for?
Use them when taking over the repository, developing its CLI or services, understanding its pnpm monorepo, or checking its architecture and release history.
Why use it?
They give an incoming developer the project background, package layout, release status, ports, data location, and documents needed to work safely.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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 ai-productivity-tracker AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/yorha1998/ai-productivity-tracker/agents-md.svg)](https://agentmods.dev/instructions/yorha1998/ai-productivity-tracker/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/yorha1998/ai-productivity-tracker/agents-md"><img src="https://agentmods.dev/badge/instructions/yorha1998/ai-productivity-tracker/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 6,127 This file is loaded in full into every session.
When invoked 6,127 The same file — it is already loaded in full.
Security scan A 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.06127 $0.06127
Opus 5 $0.03063 $0.03063
Sonnet 5 $0.01225 $0.01225
Haiku 4.5 $0.00613 $0.00613

Measured 8d ago against content hash 25302730932a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

ai-productivity-tracker AGENTS.md scanned grade A 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- 必须装 `truesight-agent` 后台服务(macOS launchd plist)+ 手动 curl 下载 `~/Downloads/ai-productivity-mcp.mjs`
AGENTS.md · 415 lines

How it starts

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

AGENTS — AI 开发上下文交接

给接手本仓库的 AI 助手看(Cursor / Claude Code / Codex 等 IDE 工具会优先加载本文件作为 系统级上下文)。5 分钟读完即可上手开发,人类开发者也可作为 onboarding 入口。

文件位置:仓库根目录 AGENTS.md(社区约定)。 最后更新:2026-05-25(@ai-productivity-tracker/[email protected] 已 publish)。


0. TL;DR(30 秒读完)

  • 项目名:@ai-productivity-tracker/cli,独立 npm 包,GitHub 仓库 YoRHa1998/ai-productivity-tracker
  • 能力:跨 IDE(Cursor / Claude Code / 任意 MCP 客户端)采集 AI 编码会话数据,按 Jira 需求维度可视化提效
  • 当前状态:rc.8 已 publish 到 npm,端到端可用(rc.1-rc.6 已全部 deprecate;rc.7 / rc.8 仍可用,rc 链上发布工程坑全部入档 docs/CHANGELOG.md)
  • 由来:从 instant-web-tools 平台模块迁出,代码 1:1 行为继承自该仓库 v2.18.0
  • 包结构:pnpm monorepo,7 个子包(core / hook-core / mcp / server / ui / cli + 不发布的 ui)
  • 默认端口:17350;数据根:~/.ai-productivity-tracker/data/

进入开发前必读 3 份文档(按优先级):

  1. [docs/PRD.md](./docs/PRD.md) — 完整设计:为什么这么搭、各 phase 拆分、14 个验收用例、18 条风险矩阵
  2. [docs/CHANGELOG.md](./docs/CHANGELOG.md) — 8+ 条发布工程经验 + rc.1→rc.6 deprecation 链 + rc.7/rc.8 release notes
  3. [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) — 进程拓扑 / 状态机 / sentinel 时序

1. 项目背景(为什么会有这个仓库?)

1.1 工具本身做什么

在任意业务仓库内,把 IDE(Cursor / Claude Code 等任意 MCP 客户端)与 AI 模型的对话过程, 按 Jira 需求(feature/INSTANT-1234-xxx 分支识别)收集成结构化指标:

  • 需求级:提效倍数(boost) / 关联 Bug 数 / token 成本 / 累计思考时长 / numstat diff
  • 每轮对话:一句话总结 / 改动范围 / 讨论摘要 / 思考时长 / 触发 stop_reason
  • 跨需求:可复用的复盘经验(lessons-learned),按 type / scope 二级分类自动合并

数据全部落用户本机 ~/.ai-productivity-tracker/data/,不上云,不联网。 浏览器看板默认 http://127.0.0.1:17350 实时展示。

1.2 这是个迁移项目,不是从零做

源代码完全继承自 [instant-web-tools](../../truesight/instant-web-tools) 仓库的 AI 提效面板模块(spec 版本 v2.18.0):

来源 现位置
apps/local-agent-service/src/services/ai-productivity/ packages/core/src/
apps/local-agent-service/src/routes/ai-productivity.ts packages/server/src/routes/ai-productivity.ts
apps/local-agent-service/src/services/skill-sync.ts packages/server/src/skill-sync.ts
packages/ai-productivity-hook-core/ packages/hook-core/
packages/ai-productivity-mcp/ packages/mcp/
apps/web/src/modules/ai-productivity-tracker/ packages/ui/
skills/{ai-productivity-init,ai-productivity-track,lessons-extract,clarify-requirement}/ skills/

Read the full file on GitHub · 415 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 First seen · 415 lines · 6,127 tokens per session scan A 25302730932a

Subscribe to this mod's changes

ai-productivity-tracker AGENTS.md is an instructions file published in the GitHub repository YoRHa1998/ai-productivity-tracker (4 stars, last pushed 2mo ago), licensed MIT. It adds 6,127 tokens to every session, about $0.0306 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). 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

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,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

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 · 6,785 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, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 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,469 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens