Home / bytedance / deer-flow · GitHub

AGENTS.md@frontendA

AGENTS.md@frontend from bytedance/deer-flow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add bytedance/deer-flow/frontend/AGENTS.md@git:20261017.072e48a

Pins git:20261017.072e48a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
bytedance/deer-flow
Path
frontend/AGENTS.md
Versions recorded
49
Latest version
git:20261017.072e48a, committed Oct 17, 2026
First version recorded
Aug 24, 2026
Size
32,539 bytes
Repository stars
84,193
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

This is the source of truth for DeerFlow frontend coding agents; the sibling `CLAUDE.md` imports it via `@AGENTS.md`.

## Project Overview

DeerFlow's Next.js 16 frontend provides thread-based AI conversations with streaming responses, artifacts, skills, and tools through a LangGraph backend.

**Stack**: Next.js 16, React 19, TypeScript 5.8, Tailwind CSS 4, pnpm 10.26.2. Requires Node.js 22+ and pnpm 10.26.2+.

### Core dependencies

- **LangGraph SDK** (`@langchain/langgraph-sdk` ^1.5.3) — Agent orchestration and streaming
- **LangChain Core** (`@langchain/core` ^1.1.15) — Fundamental AI building blocks
- **TanStack Query** (`@tanstack/react-query` ^5.90.17) — Server state management
- **UI**: Shadcn UI, MagicUI, React Bits, and Vercel AI SDK elements (generated from registries — see Code Style)

`pnpm-workspace.yaml` overrides vulnerable `@xmldom/xmldom` 0.9.x releases to
0.9.12 for GHSA-965w-775f-mr7g. Nextra pulls it in through MathJax and
`speech-rule-engine@4.1.2`, which pins 0.9.8. Keep the override until the
upstream dependency chain resolves a patched version without it; regenerate
`pnpm-lock.yaml` and verify the docs build when changing this constraint.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bytedance/deer-flow/frontend/AGENTS.md@sha256:b6427604ad928bc8

The line at the top of this page pins the label git:20261017.072e48a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ojau2t2w6qqelph3.svg)](https://markdownregistry.com/a/art_ojau2t2w6qqelph3)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 49 versions of this file, between Aug 24, 2026 and Oct 17, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261017.072e48a latest2026-10-17 072e48a 32,539 BA view · diff
git:20261016.34316552026-10-16 3431655 32,805 BA view · diff
git:20261016.ec07de92026-10-16 ec07de9 32,743 BA view · diff
git:20261014.96f930f2026-10-14 96f930f 32,700 BA view · diff
git:20261014.517a8302026-10-14 517a830 32,394 BA view · diff
git:20261014.201b9842026-10-14 201b984 32,353 BA view · diff
git:20261014.cb90f5d2026-10-14 cb90f5d 32,719 BA view · diff
git:20261013.e98179a2026-10-13 e98179a 32,592 BA view · diff
git:20261012.5ae95e62026-10-12 5ae95e6 31,873 BA view · diff
git:20261012.8cec4692026-10-12 8cec469 32,519 BA view · diff
git:20261011.3f71b2e2026-10-11 3f71b2e 31,321 BA view · diff
git:20261011.2f4f4d42026-10-11 2f4f4d4 31,107 BA view · diff
git:20261011.782fed92026-10-11 782fed9 29,969 BA view · diff
git:20261007.35cdcab2026-10-07 35cdcab 29,364 BA view · diff
git:20261006.2dd2e542026-10-06 2dd2e54 27,664 BA view · diff
git:20261006.3606c4a2026-10-06 3606c4a 26,133 BA view · diff
git:20261005.cdbcc0d2026-10-05 cdbcc0d 25,792 BA view · diff
git:20261004.648870b2026-10-04 648870b 25,480 BA view · diff
git:20261003.35023bb2026-10-03 35023bb 25,317 BA view · diff
git:20261003.b0c1b2e2026-10-03 b0c1b2e 25,184 BA view · diff
git:20261002.9ff47cf2026-10-02 9ff47cf 24,816 BA view · diff
git:20261001.9f5897c2026-10-01 9f5897c 24,428 BA view · diff
git:20261001.9c752362026-10-01 9c75236 24,267 BA view · diff
git:20260930.4c05e882026-09-30 4c05e88 23,924 BA view · diff
git:20260930.f119cac2026-09-30 f119cac 22,814 BA view · diff
git:20260924.bcaf6db2026-09-24 bcaf6db 22,578 BA view · diff
git:20260923.2a9beb32026-09-23 2a9beb3 21,438 BA view · diff
git:20260922.e2f19d82026-09-22 e2f19d8 21,436 BA view · diff
git:20260920.1e3bfa02026-09-20 1e3bfa0 19,941 BA view · diff
git:20260920.8ef58ea2026-09-20 8ef58ea 19,637 BA view · diff
git:20260919.42334f22026-09-19 42334f2 19,022 BA view · diff
git:20260918.d8db4e12026-09-18 d8db4e1 15,730 BA view · diff
git:20260918.73590a62026-09-18 73590a6 15,400 BA view · diff
git:20260918.6d725f12026-09-18 6d725f1 14,927 BA view · diff
git:20260916.a246c922026-09-16 a246c92 14,490 BA view · diff
git:20260913.c3adc512026-09-13 c3adc51 13,945 BA view · diff
git:20260912.4501c762026-09-12 4501c76 13,340 BA view · diff
git:20260912.ac2b6412026-09-12 ac2b641 12,789 BA view · diff
git:20260911.ed8a3ad2026-09-11 ed8a3ad 12,417 BA view · diff
git:20260911.f52818f2026-09-11 f52818f 12,043 BA view · diff
git:20260910.48a89782026-09-10 48a8978 11,645 BA view · diff
git:20260909.05432f42026-09-09 05432f4 11,187 BA view · diff
git:20260908.dfaeef32026-09-08 dfaeef3 10,920 BA view · diff
git:20260908.9fda4322026-09-08 9fda432 10,238 BA view · diff
git:20260906.98b8e462026-09-06 98b8e46 9,366 BA view · diff
git:20260901.ddd9aec2026-09-01 ddd9aec 8,491 BA view · diff
git:20260829.73e36992026-08-29 73e3699 8,756 BA view · diff
git:20260827.bdd68462026-08-27 bdd6846 8,651 BA view · diff
git:20260824.1aa813d2026-08-24 1aa813d 8,269 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (32539 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bytedance/deer-flow · 84,193 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ojau2t2w6qqelph3
GET https://markdownregistry.com/api/v1/resolve?ref=bytedance/deer-flow/frontend/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/b6427604ad928bc82d68f0c718c70c94a79efbe8715406fb9fd292a741233212

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from bytedance/deer-flow

blocking-io-guard SKILL.md skill
bytedance/deer-flow · .agent/skills/blocking-io-guard/SKILL.md · Ensure async-path backend code that could block the asyncio event loop is protected by a teeth-verified runtime anchor…
git:20260612.dc2abab · audit A · 84,193 stars
deerflow-maintainer-orchestrator SKILL.md skill
bytedance/deer-flow · .agent/skills/deerflow-maintainer-orchestrator/SKILL.md · Use when a DeerFlow maintainer needs comment-only GitHub issue or PR handling: resolve issue/PR scopes with gh, analyze…
git:20260616.65fab1d · audit A · 84,193 stars
engineer-system-change SKILL.md skill
bytedance/deer-flow · .agent/skills/engineer-system-change/SKILL.md · Evaluate and carry out non-trivial software-system changes from first principles. Use when assessing RFCs, issues…
git:20260723.2af2fb5 · audit A · 84,193 stars
smoke-test SKILL.md skill
bytedance/deer-flow · .agent/skills/smoke-test/SKILL.md · End-to-end smoke test skill for DeerFlow. Guides through: 1) Pulling latest code, 2) Docker OR Local installation and…
git:20260619.525ec0a · audit A · 84,193 stars
AGENTS.md AGENTS.md file
bytedance/deer-flow · AGENTS.md
git:20261020.2c880a3 · audit A · 84,193 stars
CLAUDE.md CLAUDE.md file
bytedance/deer-flow · CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,193 stars
AGENTS.md@backend AGENTS.md file
bytedance/deer-flow · backend/AGENTS.md
git:20261020.d85e0e8 · audit A · 84,193 stars
CLAUDE.md@backend CLAUDE.md file
bytedance/deer-flow · backend/CLAUDE.md
git:20260625.ff7ecdb · audit B · 84,193 stars
AGENTS.md@backend/app/channels AGENTS.md file
bytedance/deer-flow · backend/app/channels/AGENTS.md
git:20261019.085924a · audit A · 84,193 stars
AGENTS.md@backend/app/gateway AGENTS.md file
bytedance/deer-flow · backend/app/gateway/AGENTS.md
git:20261019.085924a · audit A · 84,193 stars
AGENTS.md@backend/app/gateway/routers AGENTS.md file
bytedance/deer-flow · backend/app/gateway/routers/AGENTS.md
git:20261017.169002a · audit A · 84,193 stars
AGENTS.md@backend/packages/harness/deerflow AGENTS.md file
bytedance/deer-flow · backend/packages/harness/deerflow/AGENTS.md
git:20261016.9c74b15 · audit A · 84,193 stars

Every file in bytedance/deer-flow

Other files named AGENTS.md@frontend

AGENTS.md@frontend AGENTS.md file
agentrq/agentrq · frontend/AGENTS.md
git:20261006.4681b9d · audit A · 1,161 stars
AGENTS.md@frontend AGENTS.md file
fergana-labs/stash · frontend/AGENTS.md
git:20261022.7c80ddf · audit A · 340 stars
AGENTS.md@frontend AGENTS.md file
gosuda/portal-tunnel · frontend/AGENTS.md
git:20260804.df9da5d · audit A · 288 stars
AGENTS.md@frontend AGENTS.md file
tam159/next-role · frontend/AGENTS.md
git:20260921.0792dba · audit A · 62 stars
AGENTS.md@frontend AGENTS.md file
valaris-studio/backplane · frontend/AGENTS.md
git:20260916.fb4d7ad · audit A · 25 stars

Browse by kind, by grade A, or by owner.