agentmods.dev

oh-my-sage: Instructions file for Codex

AGENTS.md

oh-my-sage AGENTS.md is an instructions file for Codex, OpenCode from allocnode/oh-my-sage. It costs 2,691 tokens per session, scanned A, original, MIT.

Project instructions for a Xiaomi smart-home AI agent with a web application and a Model Context Protocol server, which lets AI assistants call connected tools. They describe its architecture, commands, and manual testing approach.

In plain words
What is it for?
They are for developing the Next.js and TypeScript web app, building the MCP server, running lint and type checks, and carrying out its manual integration tests.
Why use it?
They give contributors the project context and the commands needed to build, check, and run its two modes.

Instructions file for CodexOpenCode

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

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

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is import { GatewayClient } from '../gateway/client';.

not rated 122repo +5 changed 3d ago A scan 2,691 tokens original MIT
View source ↗ allocnode/oh-my-sage
Reuse

Borrowing it

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

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 oh-my-sage AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/allocnode/oh-my-sage/agents-md"><img src="https://agentmods.dev/badge/instructions/allocnode/oh-my-sage/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,691 This file is loaded in full into every session.
When invoked 2,691 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.02691 $0.02691
Opus 5.5 $0.01076 $0.01076
Sonnet 5.5 $0.00538 $0.00538
Haiku 4.5 $0.00269 $0.00269

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

Security

Grade A, and why

oh-my-sage 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 · 156 lines

How it starts

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

AGENTS.md - oh-my-sage

Project Overview

Xiaomi Mijia smart home AI Agent with dual-mode architecture:

  • Web Mode: Next.js 14 + TypeScript + Ant Design + Vercel AI SDK
  • MCP Mode: Model Context Protocol server for AI coding assistants

Communicates with Xiaomi gateway via WebSocket+ECJPAKE. Uses LLM tool-calling for smart home automation.

Key Commands

# Web development
npm run dev              # Start Next.js dev server
npm run build            # Production build

# MCP development  
npm run build:mcp        # Build MCP server only
npm link                 # Link oh-my-sage-mcp globally to test a local build (users install from npm)
npm run build:npm        # Assemble the publishable oh-my-sage-mcp package in dist/npm

# Quality checks
npm run lint             # ESLint (next/core-web-vitals)
npx tsc --noEmit         # TypeScript strict mode check
npx tsc --noEmit -p tsconfig.mcp.json   # MCP build type check

# Testing
npm run test:unit        # node:test via tsx, runs tests/**/*.test.ts
npx tsx --test <file>    # Run a single test file

Note: No Jest/Vitest. Unit tests use the built-in node:test runner through tsx and never touch a real gateway. The npm run test script points at src/test.ts, which does not exist; use test:unit.

Dual Architecture

Web Mode (src/)

  • src/app/ - Next.js App Router, API routes, pages
  • src/components/ - React UI (Chat, DevicePanel, etc.)
  • src/server/ - Backend: AI/LLM integration, Agent core, shared gateway singleton, Session store, Skill loader

MCP Mode (src/core/ + src/mcp/)

  • src/core/ - Shared Core library (tools, gateway client, types), also used by Web mode
  • src/mcp/ - MCP Server implementation
  • dist/mcp/ - Build output for MCP

MCP Development

Building: npm run build:mcp outputs to dist/mcp/mcp/index.js

Global command: users get oh-my-sage-mcp from npm (npx -y oh-my-sage-mcp or npm install -g); npm link is only for testing a local build

Read the full file on GitHub · 156 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 Changed · +6 lines · +570 tokens per session b82b16aac4de
  2. 4d ago Changed · +3 tokens per session b47bc759e242
  3. 5d ago Changed · +306 tokens per session 963b90f920e9
  4. 15d ago Changed · +18 lines · +794 tokens per session c88963549284
  5. 2mo ago First seen · 132 lines · 1,018 tokens per session scan A 63865504e4eb

Subscribe to this mod's changes

oh-my-sage AGENTS.md is an instructions file published in the GitHub repository allocnode/oh-my-sage (122 stars, last pushed 4d ago), licensed MIT. It adds 2,691 tokens to every session, about $0.0108 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.

Backend and APIsHardware and IoT
Related

oh-my-sage AGENTS.md compared with instructions from other repositories

oh-my-sage AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
oh-my-sage AGENTS.mdallocnode/oh-my-sageInstructions file1224d agoMITA2,691Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode