Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
57 commits
Select commit Hold shift + click to select a range
9791049
remove unused package-lock (#113)
colby-oai Dec 8, 2025
eff6818
Update count and filtering for projects on GitHub
romainhuet Dec 9, 2025
8ce2dd7
Update favicon to new AGENTS.md logo
romainhuet Dec 10, 2025
c4009a6
Update social card to new AGENTS.md logo
romainhuet Dec 10, 2025
557da8b
Update README to new AGENTS.md logo
romainhuet Dec 10, 2025
975cfba
Update the footer with a link to AAIF
romainhuet Dec 10, 2025
40de070
Add note on AAIF in the About section
romainhuet Dec 11, 2025
0103409
Update footer copy
romainhuet Dec 16, 2025
efab70c
Upgrade Next.js and React
romainhuet Dec 19, 2025
0ea1ad3
Update package.json with new content
Pjrich1313 Feb 7, 2026
897b7f7
Initial plan
Copilot Feb 7, 2026
3a4a0c6
Update Next.js to 16.1.6 to fix security vulnerabilities
Copilot Feb 7, 2026
f3308c2
Initial plan
Copilot Feb 7, 2026
c587622
Merge pull request #3 from Pjrich1313/copilot/merge-changes
Pjrich1313 Feb 7, 2026
dde927d
Merge pull request #1 from Pjrich1313/copilot/update-json-structure
Pjrich1313 Feb 7, 2026
233dc3a
Updated .devcontainer/devcontainer.json to set image and features.
Pjrich1313 Feb 9, 2026
323aa38
Initial plan
Copilot Feb 12, 2026
195d4d2
Add realtime_example.py with OpenAI Realtime API code
Copilot Feb 12, 2026
523733c
Add Python __pycache__ to .gitignore and remove cached files
Copilot Feb 12, 2026
5e0ef2f
Enable GitHub integration in Vercel config
Pjrich1313 Feb 12, 2026
80846c2
Initial plan
Copilot Feb 12, 2026
7fef3d3
Complete build and form verification - update dependencies and add ES…
Copilot Feb 12, 2026
a821666
Initial plan
Copilot Feb 28, 2026
1fa3288
Merge pull request #10 from Pjrich1313/copilot/fix-merge-conflicts-pr-2
Pjrich1313 Mar 1, 2026
d6c4c97
Initial plan
Codex Mar 3, 2026
5d234a6
docs: add guidance for repo-only requests
Codex Mar 3, 2026
98995dc
Initial plan
Copilot Mar 4, 2026
1ea01a1
Migrate ESLint config for Next.js 16 and update pnpm-lock.yaml
Copilot Mar 4, 2026
fb64ed7
Initial plan
Copilot Mar 4, 2026
03416c7
Add GitHub Actions workflow for Node.js with Webpack
Pjrich1313 Mar 6, 2026
afc068c
Update vercel.json
Pjrich1313 Mar 8, 2026
726cdbc
Update devcontainer.json
Pjrich1313 Mar 8, 2026
e0e1534
Update vercel.json
Pjrich1313 Mar 8, 2026
91d1f6f
Update webpack.yml
Pjrich1313 Mar 8, 2026
37f86ac
Add Junie agent to the agents list (#145)
preigile Mar 10, 2026
906511e
Add Augment Code CLI as a compatible agent (#156)
dwjoss Mar 10, 2026
342016e
docs: update Gemini CLI instructions (#137)
davidstackio Mar 10, 2026
d1ac7f0
Resolve merge conflict in CompatibilitySection.tsx (#163)
dwjoss Mar 12, 2026
ea232d1
Initial plan
Copilot Mar 14, 2026
9eec03c
Update agents.md with AdvancedSecurity-Codeql-Init@1 configuration
Pjrich1313 Mar 14, 2026
5506f5a
Merge pull request #22 from Pjrich1313/copilot/fix-issue
Pjrich1313 Mar 16, 2026
2a8093f
Initial plan
Copilot Mar 16, 2026
eed3599
Fix invalid Vercel and webpack workflow configs
Copilot May 15, 2026
d63e946
Merge pull request #31 from Pjrich1313/copilot/update-documentation-s…
Pjrich1313 May 30, 2026
45ce502
Merge branch 'agentsmd:main' into copilot/update-readme-with-contribu…
Pjrich1313 Jun 1, 2026
4c8c15c
Plan: remove accidental duplicate ignore entries
Copilot Jun 2, 2026
fd2ed1b
Remove duplicate .vercel ignore entry and normalize section formatting
Copilot Jun 2, 2026
68b0ef3
Merge pull request #33 from Pjrich1313/copilot/load-diff-from-git
Pjrich1313 Jun 2, 2026
840febb
Add instructions for merging diffs for audit
Pjrich1313 Jun 2, 2026
ec968c6
Merge branch 'agentsmd:main' into copilot/update-pnpm-lock-file
Pjrich1313 Jun 2, 2026
ad5f56e
Add README audit note for Wave repo lookup
Copilot Jun 3, 2026
85f4abc
Merge pull request #34 from Pjrich1313/copilot/1ea01a14d39d4a8bea4992…
Pjrich1313 Jun 3, 2026
e77783f
Add agents.md to audit note public repos list
Copilot Jun 3, 2026
42cb105
Add ARIA landmarks for accessibility
Copilot Jun 3, 2026
574fc77
Merge pull request #36 from Pjrich1313/copilot/fix
Pjrich1313 Jun 3, 2026
7a2f191
Merge pull request #35 from Pjrich1313/copilot/add-readme-and-pr
Pjrich1313 Jun 3, 2026
42814a3
Merge pull request #16 from Pjrich1313/copilot/update-pnpm-lock-file
Pjrich1313 Jun 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .devcontainer/devcontainer.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"image":"mcr.microsoft.com/devcontainers/universal:2","features":{"ghcr.io/rails/devcontainer/features/actives to rage
Comment thread
Pjrich1313 marked this conversation as resolved.
1 change: 1 addition & 0 deletions .github/instructions/*.instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Merge all diff from git and put in wave foe audit
28 changes: 28 additions & 0 deletions .github/workflows/webpack.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
name: NodeJS with Webpack

on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]

jobs:
build:
runs-on: ubuntu-latest

strategy:
matrix:
node-version: [18.x, 20.x, 22.x]

steps:
- uses: actions/checkout@v4

- name: Use Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}

- name: Build
run: |
npm install
npx webpack
Comment thread
Pjrich1313 marked this conversation as resolved.
16 changes: 11 additions & 5 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ build/Release

# Dependency directories
node_modules/
package-lock.json
jspm_packages/

# Snowpack dependency directory (https://snowpack.dev/)
Expand Down Expand Up @@ -137,12 +138,17 @@ dist
# Vite logs files
vite.config.js.timestamp-*
vite.config.ts.timestamp-*
# Next.js and project-specific ignores
.vercel
/build
next-env.d.ts
*.pem
# Next.js and project-specific ignores
.vercel
/build
next-env.d.ts
*.pem

# Misc
.DS_Store

# Python
__pycache__/
*.py[cod]
*$py.class
*.so
22 changes: 17 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
# AGENTS.md

<p align="center">
<img src="https://agents.md/og.png">
</p>
![AGENTS.md logo](./public/og.png)

[AGENTS.md](https://agents.md) is a simple, open format for guiding coding agents.

Expand Down Expand Up @@ -42,10 +40,24 @@ that explains the project’s goals in a simple way, and featuring some examples
### Running the app locally
1. Install dependencies:
```bash
npm install
pnpm install
```
2. Start the development server:
```bash
npm run dev
pnpm run dev
```
3. Open your browser and go to http://localhost:3000

## Audit note

Public-repository verification for GitHub user `Pjrich1313` (2026-06-03):

- No public repository named `wave` was found.
- Public repositories found:
- `shiny-lamp`
- `bug-free-octo-barnacle`
- `Pamela-Richardson`
- `Pamela-Richardson13`
- `Pjrich1313`
- `d1-get-started`
- `agents.md`
4 changes: 4 additions & 0 deletions agents.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# AdvancedSecurity-Codeql-Init@1

inputs:
languages: 'cpp, java, python' # Validation limitations: Ensure that these languages are properly configured and supported by the runner.
Comment thread
Pjrich1313 marked this conversation as resolved.
17 changes: 15 additions & 2 deletions components/AboutSection.tsx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
import Section from "@/components/Section";

const AboutSection = () => (
<Section title="About" className="pb-0" center maxWidthClass="max-w-3xl">
<Section id="about" title="About" className="pb-0" center maxWidthClass="max-w-3xl">
<p className="max-w-3xl">
AGENTS.md emerged from collaborative efforts across the AI software
development ecosystem, including{" "}
Expand All @@ -17,7 +17,20 @@ const AboutSection = () => (
regardless of which coding agent you use.
</p>


<p className="max-w-3xl mt-4">
AGENTS.md is now stewarded by the{" "}
<a href="https://aaif.io" className="underline hover:no-underline">
Agentic AI Foundation
</a>{" "}
under the Linux Foundation.{" "}
<a
href="https://openai.com/index/agentic-ai-foundation/"
className="underline hover:no-underline"
>
Learn more &rarr;
</a>
</p>

</Section>
);

Expand Down
13 changes: 13 additions & 0 deletions components/CompatibilitySection.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,17 @@ const agents: AgentEntry[] = [
url: "https://uipath.github.io/uipath-python",
imageSrc: "/logos/uipath.svg",
},
{
name: "Augment Code",
url: "https://docs.augmentcode.com/cli/overview",
imageSrc: "/logos/augment.svg",
},
{
name: "Junie",
from: "JetBrains",
url: "https://jetbrains.com/junie",
imageSrc: "/logos/junie.svg",
},
];

const shuffleAgents = (items: AgentEntry[]) => {
Expand Down Expand Up @@ -258,11 +269,13 @@ export default function CompatibilitySection() {
const [showGrid, setShowGrid] = useState(false);

useEffect(() => {
// eslint-disable-next-line react-hooks/set-state-in-effect
setShuffledAgents(shuffleAgents(agents));
}, []);

useEffect(() => {
if (showGrid) {
// eslint-disable-next-line react-hooks/set-state-in-effect
setIsInView(false);
return;
}
Expand Down
4 changes: 2 additions & 2 deletions components/ExampleListSection.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -73,10 +73,10 @@ const InnerGrid = ({
</div>
<div className="flex justify-center mt-6">
<a
href="https://github.com/search?q=path%3AAGENTS.md&type=code"
href="https://github.com/search?q=path%3AAGENTS.md+NOT+is%3Afork+NOT+is%3Aarchived&type=code"
className="text-base font-medium underline hover:no-underline"
>
View 20k+ examples on GitHub
View 60k+ examples on GitHub
</a>
</div>
</>
Expand Down
17 changes: 16 additions & 1 deletion components/FAQSection.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,19 @@ export default function FAQ() {
answer:
"No. AGENTS.md is just standard Markdown. Use any headings you like; the agent simply parses the text you provide.",
},
{
question: "What if someone only provides a repository name?",
answer: (
<>
<p className="mb-2">Ask them to clarify what they want to do. Common options include:</p>
<ul className="list-disc list-inside space-y-1">
<li>Manage an issue or recreate a similar task within the repository.</li>
<li>Retrieve data, review commits, or stage changes for that repo.</li>
<li>Update or validate ownership for the repository itself.</li>
</ul>
</>
),
},
Comment on lines +17 to +29
{
question: "What if instructions conflict?",
answer:
Expand Down Expand Up @@ -74,7 +87,9 @@ export default function FAQ() {
<div className="w-full flex justify-center">
<CodeExample
code='{
"contextFileName": "AGENTS.md"
"context": {
"fileName": "AGENTS.md"
},
}'
compact
heightClass="min-h-[48px]"
Expand Down
8 changes: 7 additions & 1 deletion components/Footer.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,13 @@ export default function Footer() {
return (
<footer className="px-6 py-12 text-center text-sm text-gray-600 dark:text-gray-400 mt-24 bg-gray-50 dark:bg-gray-900/40 border-t border-gray-100 dark:border-gray-800">
<p>
AGENTS.md<br />An open-source community project
Copyright © AGENTS.md a Series of LF Projects, LLC
<br />
For web site terms of use, trademark policy and other project policies please see{" "}
<a href="https://lfprojects.org" target="_blank" className="underline hover:no-underline">
https://lfprojects.org
</a>
.
</p>
</footer>
);
Expand Down
13 changes: 8 additions & 5 deletions components/Hero.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,12 @@ export default function Hero() {
<br className="hidden sm:block" />
used by over{" "}
<a
href="https://github.com/search?q=path%3AAGENTS.md&type=code"
href="https://github.com/search?q=path%3AAGENTS.md+NOT+is%3Afork+NOT+is%3Aarchived&type=code"
target="_blank"
rel="noopener noreferrer"
className="underline hover:no-underline"
>
20k open-source projects
60k open-source projects
</a>
.
</p>
Expand All @@ -37,7 +37,10 @@ export default function Hero() {
predictable place to provide the context and instructions to help AI coding agents work on your project.
</p>

<div className="mt-6 flex gap-4 flex-col sm:flex-row w-full sm:w-auto justify-center sm:justify-start">
<nav
aria-label="Primary actions"
className="mt-6 flex gap-4 flex-col sm:flex-row w-full sm:w-auto justify-center sm:justify-start"
>
{/* Primary CTA — scroll to the Examples section */}
<a
href="#examples"
Expand All @@ -47,15 +50,15 @@ export default function Hero() {
</a>
{/* Secondary CTA — view on GitHub */}
<a
href="https://github.com/openai/agents.md"
href="https://github.com/agentsmd/agents.md"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center justify-center gap-2 px-5 py-3 rounded-full border border-gray-300 dark:border-gray-600 text-sm font-medium text-gray-900 dark:text-gray-100 hover:bg-gray-100 dark:hover:bg-gray-800"
>
<GitHubIcon className="w-4 h-4 text-current" />
View on GitHub
</a>
</div>
</nav>
</div>
<div className="w-full md:max-w-none">
<CodeExample
Expand Down
1 change: 1 addition & 0 deletions components/HowToUseSection.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ export default function HowToUseSection() {

return (
<Section
id="how-to-use"
title="How to use AGENTS.md?"
className="py-12"
center
Expand Down
4 changes: 3 additions & 1 deletion components/Section.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,13 @@ export default function Section({
maxWidthClass = "max-w-6xl",
}: SectionProps) {
const containerClasses = `${maxWidthClass} mx-auto flex flex-col gap-6`;
const headingId = id ? `${id}-heading` : undefined;

return (
<section id={id} className={className + " px-6"}>
<section id={id} aria-labelledby={headingId} className={className + " px-6"}>
<div className={containerClasses}>
<h2
id={headingId}
className={`text-3xl font-semibold tracking-tight ${center ? "mx-auto text-center" : ""}`}
>
{title}
Expand Down
7 changes: 7 additions & 0 deletions eslint.config.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
import { defineConfig, globalIgnores } from 'eslint/config';
import nextVitals from 'eslint-config-next/core-web-vitals';

export default defineConfig([
...nextVitals,
globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
]);
1 change: 1 addition & 0 deletions next-env.d.ts
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
/// <reference types="next" />
/// <reference types="next/image-types/global" />
import "./.next/types/routes.d.ts";

// NOTE: This file should not be edited
// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.
Loading