happier AGENTS.md

Repository instructions for Happier, an open-source app that lets people monitor and control coding-agent sessions from phones, browsers, or desktops. They describe the project’s rules, structure, and expected agent behavior.

In plain words
What is it for?
They are for guiding work on Happier’s codebase, including how agents should follow project rules, route instructions, handle autonomy, and complete tasks.
Why use it?
They give coding agents the project context and constraints needed to make changes that fit the repository and its product.

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

Made for: Codex, OpenCode.

Per session 9,608 This file is loaded in full into every session.
When invoked 9,608 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.09608 $0.09608
Opus 5 $0.04804 $0.04804
Sonnet 5 $0.01922 $0.01922
Haiku 4.5 $0.00961 $0.00961

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

Security

Grade A, and why

happier 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 2d 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 · 340 lines

How it starts

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

Agent Constitution

This file is the canonical cross-tool constitution for this repository.

What Happier is

Happier is a cross-device client and companion for coding agents. Think of it as what you would get if Claude Desktop, Codex App, Cursor Glass and Conductor were merged into one open-source app.

Agent sessions run on computers, VPSs and dev boxes users control. Happier can connect to one or many of these machines and lets users monitor, steer, approve, review, resume and continue their sessions from a phone, browser or desktop.

People drive agents through Happier all day. It should feel warm, fluid, blazing-fast and delightful to use.

We love ambitious product ideas and simple systems. Do not preserve complexity because it already exists or introduce machinery because it looks architecturally impressive. Understand the real constraint, intent and requirements. Do not overcomplicate the implementation or invent hard requirements for speculative, unreachable or low-impact edge cases. New guarantees and machinery must be justified by an explicit requirement, released contract, reproduced failure or reachable material risk.

Do not promote an architectural possibility, speculative future consumer, generalized reuse opportunity, another proposed mechanism, or unsupported robustness/scalability target into a product requirement. Offline behavior, unattended execution, exact ordering or freshness, failover, trust models, and fixed capacity limits are path-specific contracts; establish each from current product evidence, a released security or compatibility obligation, or explicit approval.

Cross-device reachability, execution placement, state ownership, persistence, availability, and consistency are separate contracts. A feature being available on several clients or scoped to an Account establishes neither a server-side source of truth nor a multi-writer problem. Add shared materialization or cross-machine coordination only for a named current flow that cannot be served by reaching the canonical authority through existing transport.

Read the full file on GitHub · 340 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. 2d ago First seen · 340 lines · 9,608 tokens per session scan A 84f9011f4fd6

Subscribe to this mod's changes

happier AGENTS.md is an instructions file published in the GitHub repository happier-dev/happier (1,593 stars, last pushed 2d ago), licensed MIT. It adds 9,608 tokens to every session, about $0.0480 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-30.

Related

Other instructions, from other repositories

msu-skills CLAUDE.md

Claude Code instructions for NEXPACE-Limited/msu-skills, a project described as: Agent Skills for MapleStory Universe — a SKILL.md catalog for MSU builders. Works with Claude Code, Codex CLI, Gemini CLI, Kimi CLI, and any LLM agent that reads SKILL.md. By NEXPACE.

NEXPACE-Limited/msu-skills · 5 tokens

msu-skills GEMINI.md

Gemini CLI instructions for NEXPACE-Limited/msu-skills, a project described as: Agent Skills for MapleStory Universe — a SKILL.md catalog for MSU builders. Works with Claude Code, Codex CLI, Gemini CLI, Kimi CLI, and any LLM agent that reads SKILL.md. By NEXPACE.

NEXPACE-Limited/msu-skills · 5 tokens

msu-skills AGENTS.md

AGENTS.md instructions for NEXPACE-Limited/msu-skills, covering msu-skills, commands, contributing, core principle — one source, three channels and layout.

NEXPACE-Limited/msu-skills · 7,624 tokens

AionUi AGENTS.md

AGENTS.md instructions for iOfficeAI/AionUi, covering aionui - project guide, code conventions, file & directory structure, naming and ui library & icons.

iOfficeAI/AionUi · 1,663 tokens

botmux CLAUDE.md

Instructions for deepcoldy/botmux, covering botmux, 构建 & 运行, bun 开发链路, worktree 的 nodemodules:共享还是独立(改前必读) and 编译态(单文件二进制)注意.

deepcoldy/botmux · 4,000 tokens

codedb AGENTS.md

Instructions for justrach/codedb, covering codedb agent guidelines, what codedb is (and isn't), review guidelines, pre-merge verification and security-sensitive areas.

justrach/codedb · 509 tokens