agentmods.dev

mb: Instructions file for Codex

AGENTS.md

mb AGENTS.md is an instructions file for Codex, OpenCode from jthingelstad/mb. It costs 3,547 tokens per session, scanned A, original, MIT.

Project instructions for mb, a command-line program that lets agents and scripts work with micro.blog, a blogging platform. It describes the repository, local skills, commands, and application programming interface split.

In plain words
What is it for?
Use it when modifying mb's command-line interface, API client, configuration, output formats, repository structure, or local skills.
Why use it?
It gives coding agents the project context and rules they need to make consistent changes without mixing command usage with blog-writing behavior.

Instructions file for CodexOpenCode

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

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

not rated 5repo changed 1mo ago A scan 3,547 tokens original MIT
View source ↗ jthingelstad/mb
Reuse

Borrowing it

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

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/jthingelstad/mb/agents-md"><img src="https://agentmods.dev/badge/instructions/jthingelstad/mb/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,547 This file is loaded in full into every session.
When invoked 3,547 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.03547 $0.03547
Opus 5.5 $0.01419 $0.01419
Sonnet 5.5 $0.00709 $0.00709
Haiku 4.5 $0.00355 $0.00355

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

Security

Grade A, and why

mb 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 1mo 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 · 376 lines

How it starts

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

AGENTS.md

Guidance for coding agents working in mb.

Project Overview

mb is a command-line client for micro.blog, designed for agent and script use.

Core priorities:

  • Agent output by default
  • Agent output is the primary product surface
  • No interactive prompts
  • Composable, pipeable commands
  • Clear structured errors
  • Minimal dependencies

Local Skills

Project-local skills live under skills/:

  • skills/mb-cli/SKILL.md: core mb command usage and workflow guidance
  • skills/mb-mcp/SKILL.md: operating the mb mcp stdio tools (identity, attention, acknowledgement, one authorized write)
  • skills/mb-for-user-delegation/SKILL.md: guidance for acting on behalf of a human user
  • skills/mb-agent-blogger/SKILL.md: guidance for an agent managing its own blog identity

When working on skill-related requests, keep the operational skills (mb-cli, mb-mcp) separate from the social/voice rules in the two behavior skills.

Repository Layout

src/mb/cli.py                   Typer entrypoint, global options, mcp and operation-status
src/mb/api.py                   HTTP client for micro.blog APIs
src/mb/config.py                Config loading/saving and profile support
src/mb/formatters.py            json | human | agent output modes
src/mb/domain.py                Post normalization, thread ordering, mention classification
src/mb/services.py              Shared CLI/MCP services: identity, attention, writes, receipts
src/mb/shapes.py                schema_version, compact MCP results and per-tool output schemas
src/mb/state.py                 SQLite state file: checkpoints and write receipts
src/mb/media.py                 Local image validation for upload
src/mb/mcp_server.py            Optional stdio MCP server (mcp extra only)
src/mb/guidance/                Packaged guidance served as mb://guide
src/mb/commands/catchup.py      New timeline posts since catchup checkpoint
src/mb/commands/checkpoint.py   Checkpoint list/get/set/clear
src/mb/commands/doctor.py       Read-only health check
src/mb/commands/guide.py        `mb guide` workflow text
src/mb/commands/heartbeat.py    Session-start snapshot
src/mb/commands/inbox.py        Attention-oriented mention triage
src/mb/commands/lookup.py       Pipeline enrichment for users and posts
src/mb/commands/media.py        Image preview and upload
src/mb/commands/post.py         Post new/short/get/edit/reply/delete/list/publish/replies
src/mb/commands/timeline.py     Timeline, discover, check, checkpoint
src/mb/commands/conversation.py Conversation thread formatting
src/mb/commands/user.py         User and social graph commands
src/mb/commands/blog.py         Read own posts, categories, search
src/mb/commands/upload.py       `mb upload` alias for media upload
tests/                          Unit and CLI integration tests
scripts/                        Distribution checks run in CI; live_smoke.py (live test account)

Read the full file on GitHub · 376 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. 1mo ago Changed · +6 lines · +453 tokens per session f517fe2d1a64
  2. 1mo ago Changed · +34 lines · +795 tokens per session d2328ea267f9
  3. 2mo ago First seen · 336 lines · 2,299 tokens per session scan A 602121bcfcbc

Subscribe to this mod's changes

mb AGENTS.md is an instructions file published in the GitHub repository jthingelstad/mb (5 stars, last pushed 2d ago), licensed MIT. It adds 3,547 tokens to every session, about $0.0142 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-31.

Pythonagent-skillscliindiewebmicrodotblogmicropub
Related

mb AGENTS.md compared with instructions from other repositories

mb AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
mb AGENTS.mdjthingelstad/mbInstructions file52d agoMITA3,547Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,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