What is LangBot AGENTS.md?

A set of repository instructions for developing LangBot, including its architecture, commands, tests, and links to the related SDK. LangBot is an application for building and running chat bots and agent integrations.

It helps orient work in LangBot, choose focused tests, run the backend and web frontend, and handle changes spanning plugins, runtimes, MCP, storage, or the SDK.

It gives the agent project-specific rules and facts before making changes, reducing the chance of using the wrong command, folder, or interface.

LangBot AGENTS.md — Instructions file by langbot-app

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/langbot-app/langbot/agents-md

Clone the repo

git clone --depth 1 https://github.com/langbot-app/LangBot

Made for: Codex, OpenCode.

Per session 1,190 This file is loaded in full into every session.

When invoked 1,190 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.

Model	Per session	Once invoked
Fable 5	$0.01190	$0.01190
Opus 5	$0.00595	$0.00595
Sonnet 5	$0.00238	$0.00238
Haiku 4.5	$0.00119	$0.00119

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

Security

Grade A, and why

LangBot 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 · 116 lines

How it starts

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

AGENTS.md

This file guides code agents working in the LangBot main repository. CLAUDE.md is a symlink to this file.

Read ARCHITECTURE.md before non-trivial backend, frontend, runtime, plugin, Box, MCP, persistence, or cross-repo SDK changes. This file is the working checklist; ARCHITECTURE.md is the system map.

Quick Facts

Python backend: >=3.11,<4.0, dependencies managed by uv.
Frontend: web/ is Vite + React Router 7 + shadcn/ui + Tailwind, managed by pnpm.
Backend framework: Quart served by Hypercorn on api.port, default 5300.
Frontend dev server: web/ on 3000, with VITE_API_BASE_URL pointing at the backend.
Plugin/Box/runtime contracts live in sibling repo langbot-plugin-sdk, pinned as langbot-plugin in pyproject.toml.

Essential Commands

uv sync --dev
uv run main.py
uv run pre-commit install

cd web
pnpm install
pnpm dev
pnpm build

Useful focused tests:

uv run pytest tests/unit_tests -q
uv run pytest tests/integration -q
uv run pytest tests/integration/persistence -q
uv run pytest tests/manual/mcp_smoke.py

cd web
pnpm lint
pnpm test:e2e

Run the narrowest useful test first, then broader checks when confidence is needed.

Where to Look

Architecture map: ARCHITECTURE.md.
Dev environment guide: https://docs.langbot.app/zh/develop/dev-config.
Plugin runtime / CLI / SDK debugging: https://docs.langbot.app/zh/develop/plugin-runtime.
API-key auth: docs/API_KEY_AUTH.md.
Box deep-dive notes: docs/review/box-architecture.md and related files.
In-repo skills: skills/ is the single source of truth for LangBot agent skills.
SDK repo: ../langbot-plugin-sdk/ when changing shared entities, plugin APIs, action protocol, lbp rt, or lbp box.

Cross-Repo SDK Work

When changing SDK contracts used by LangBot:

# from langbot-plugin-sdk, with LangBot's .venv active
uv pip install .

# from LangBot, preserve the locally installed SDK
uv run --no-sync main.py

For standalone runtime debugging:

Read the full file on GitHub · 116 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.

2d ago First seen · 116 lines · 1,190 tokens per session scan A d18c55fdba3d

Subscribe to this mod's changes

LangBot AGENTS.md is an instructions file published in the GitHub repository langbot-app/LangBot (17,616 stars, last pushed 2d ago), licensed Apache-2.0. It adds 1,190 tokens to every session, about $0.0060 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.

LLM agent openai qq telegram wechat

open-swe AGENTS.md

AGENTS.md instructions for langchain-ai/open-swe, covering agents.md, project, commands, architecture and entrypoints.

langchain-ai/open-swe · 3,814 tokens

open-swe CLAUDE.md

Claude Code instructions for langchain-ai/open-swe, covering claude.md, project, commands, architecture and entrypoints.

langchain-ai/open-swe · 2,954 tokens

awesome-ChatGPT-repositories CLAUDE.md

Claude Code instructions for taishi-i/awesome-ChatGPT-repositories, covering awesome-chatgpt-repositories — claude code guide, repository structure, plugin skill (when installed via /plugin), local standalone command (when repo is cloned) and compact data format (plugins/awesome-chatgpt-search/data/).

taishi-i/awesome-ChatGPT-repositories · 995 tokens

dify AGENTS.md

AGENTS.md instructions for langgenius/dify, covering agents.md, repository gotchas and frontend workflow.

langgenius/dify · 222 tokens

dify CLAUDE.md

Claude Code instructions for langgenius/dify, a project described as: Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

langgenius/dify · 3 tokens

flock AGENTS.md

Instructions for Onelevenvy/flock, covering agents.md, project overview, build & development commands, rust backend and build the cli.

Onelevenvy/flock · 2,131 tokens