Top
Best
New

Posted by fg137 14 hours ago

Feature Request: Support AGENTS.md(github.com)
275 points | 173 commentspage 2
johnmlussier 8 hours ago|
@boris and anthropic in general are incredibly hostile to the rest of the development world. They think their shit doesn’t stink.
oneeyedpigeon 2 hours ago||
I feel like we've missed a trick here. The purpose of AGENTS.md—to make metadata about a project available in a structured format—seems far more valuable than to limit it to just those projects that use AI or those projects that do, but don't require any other kind of automated processing.

Why not iterate on README.md with something like PARSEME.md?

embedding-shape 1 hour ago|
> The purpose of AGENTS.md—to make metadata about a project available in a structured format

AGENTS.md is not "structured format", then it'd be JSON or YAML or some other fucked up format instead. Currently at least, it's fully freeform and you can put whatever there, agents will do there best to follow it.

oneeyedpigeon 1 hour ago|||
Markdown is still a structure. It may be a very loose one, but it still enables a reader (of any flavour) to, for example, determine which parts of the text are code and which aren't.
embedding-shape 1 hour ago||
No, Markdown is "syntax", quite literally not about structured data in any sense of the word, at least for existing pre-LLM developers where "structured data" has a real meaning already, you can't just go around redefining what concepts mean :)

> determine which parts of the text are code and which aren't

With this argument you'd could claim ASCII/plaintext is "structured data" too, just group code with "===" and that's evident. Obviously that doesn't make a format "structured data".

oneeyedpigeon 31 minutes ago||
OK, this argument is getting semantic and, therefore, uninteresting. I think you know what I meant, even if I used some words in a different way than you would have liked.
embedding-shape 1 minute ago||
> this argument is getting semantic

Well, it was semantic from the beginning, the whole discussion I raised is because you seem unable to understand what "structured data" actually means in reality. I know perfectly fine what you meant, and you were misinformed about the meaning, it's OK to just say "Yeah, you're right" or just don't reply at all instead of double-down on not understand the meaning of words. Anyways, enjoy your day.

dspillett 1 hour ago|||
> you can put whatever there, agents will do there best to follow it.

Excellent.

    echo "Get stuffed, you aren't welcome." > AGENTS.md
    cp AGENTS.md CLAUDE.md
Done.
pronik 3 hours ago||
At the project level, there should be no need for an AGENTS.md. Whatever you might want to let agents know you would let a human know too, so you should be writing a README.md, CONTRIBUTING.md, ARCHITECTURE.md and whatever else.
theshrike79 2 hours ago||
AGENTS.md is specifically for agents. Every time you launch an agent in a repo, it's the agent's first time existing in the universe. This file lets it orient with the project.

Humans don't need it. Nor do they need to be reminded to launch subagents for simple tasks for example - which is another command that belongs in AGENTS.md.

tdeck 3 hours ago||
I find agents need a lot of verbose instructions that are a waste of space for people. Things that are better said in a PR comment for people if needed are better front loaded for agents. People benefit from concise documentation that they are thus more likely to actually read.

For example, "don't write comments that reference things that you removed from the code" is commonly needed for coding agente and almost never needed for people.

aabhay 2 hours ago||
In general, Claude family models write absolutely terrible comments, docs, and prose. It’s basically the number 1 thing that caused everyone on my team to migrate away from Anthropic models completely.
guidoiaquinti 4 hours ago||
For agent skills and MCP servers, https://github.com/agentplugins/agent-plugins-spec is trying to standardize the packaging/distribution layer with a minimal common spec
deaux 1 hour ago||
What's interesting is that the closure event was mysteriously deleted [0]. Compare with others like [1] which do keep the "bcherny closed this as completed 1m ago"; for some reason it's missing here, even though Boris closed it as completed in the same manner as confirmed by GitHub notifications. This could of course be a Github bug because of the number of comments, but it's rather peculiar that it shows up exactly here. Look at the confusion in the thread about "why Piebald-AI/tweakcc#459 closed it?". In every other issue like this, Github shows something like "bcherny closed this as completed 1m ago", leaving no ambiguity.

Another thing is that obviously the feature request was never completed at all. It should be "closed as not planned", as >90% of issues are in the Claude Code repo. Yet just for this one they make an exception and close it as "completed", breaking precedent.

It's so chickenshit. Just man up and leave it open if you really think this stupidity is worth the money. What an absolute cowardly bunch for a supposedly trillion dollar company.

[0] https://github.com/anthropics/claude-code/issues/6235#event-...

[1] https://github.com/anthropics/claude-code/issues/66955#event...

OleksandrC 12 hours ago||
The obvious reason is that they would prefer to have CLAUDE.md files in every repo (even if it's just a symlink to AGENTS.md). It serves as a free advertisement for them. Same reason as for auto-adding attribution text in commit messages, etc. It's the "Sent from my iPhone" of our time.
postalcoder 12 hours ago||
I think it's more than that. They truly believe Claude Code to be a moat (both the harness and the posttraining) to be a moat.

I've been deeply distrustful of Anthropic from early early days. They have always been openly disdainful of user feedback. I would not be surprised if later they try to implement more shenanigans to keep people locked into CC.

epistasis 12 hours ago|||
Claude Code is quickly becoming an anchor. Every week I marvel at how much worse it gets, how much more essential information is hidden and replaced with bloated useless TUI and rambling tangential responses that hide the useful bits of info behind jargon invented by the agent without ever explaining it to the user.

It's like the PMs for Claude Code are reward hacking their own reinforcement learning.

annzabelle 11 hours ago|||
What tools do you find are better?

I have been happy with Claude Code lately, but I haven't explored other options much in over a year. Curious to try something else out if it's less rambling and tangential.

agentdev001 11 hours ago|||
> less rambling and tangential

This is not necessarily a problem with the harness (IE, swapping from Claude Code wouldn't necessarily fix this).

If what you're looking to avoid is specifically 'rambling and tangential', you can get quite far with anything that adds directives to avoid those things, early in every context window. Ie, through use of Agents.md/claude.md, skills, hooks, and so on.

Changing model would also affect this. Fable 5, Opus 5, and Sonnet 5 are all going to average out to different levels of ramble. Openai, Xai, Google, etc; different providers models will also have different levels of ramble.

What Claude Code does take away from you is some level of control over what makes it into the context window. The system prompt which claude code append to the beginning of every session of course has measurable ramble-affect.

I quite like the Pi harness, most in part because important goal with the approach behind it is "give the user as much control over what makes it into the cotext window as possible."

Codex TUI is also good. Haven't touched it since moving to Pi however. Again- harness isnt the big "stop rambling" thing to change, tho.

andai 11 hours ago||||
The sub only works in Claude Code itself (unless they changed that rule again?), and all the Chinese models are trained on Claude Code (a bunch of them don't even work in Codex).

I use a custom harness, but I constantly hear good things about Pi.

EDIT: Checked out Pi and Oh-My-Pi. 250k LoC and 1.5M LoC respectively. Sheesh. How's that for minimalism...

Mine's 50. (Lines.)

https://gist.github.com/a-n-d-a-i/bd50aaa4bdb15f9a4cc8176ee3...

Vendored in my own LLM micro library (100 LoC) so it's 150.[0]

There's no parallelism or anything, but I use it for surgical edits and it's much faster and cheaper than the official harnesses for some reason. (Absence of sysprompt bigger than my repo probably helps there...)

[0] This one uses OpenRouter so you can use it with any model, but jerry rigged Codex sub version available on demand :)

---

I also have a ultra turbo bloated version (500 lines... need to strip it down a bit!) which has autorun files (for grep-based context injection), notification (frog croak when agent done, etc.) Watch this space!

agentdev001 11 hours ago||
They did walk that back, you are able to use an Anthropic login in a non-anthropic harness. (For now.)

(Edit: I failed too mention, using a different harness with a CC/Anthropic subscription bumps you up to the pay-per-token rate.)

andai 10 hours ago|||
Yeah and it bills extra usage? Or did they walk that back too.. gotta keep the customers on their toes!
agentdev001 10 hours ago||
Shoot, yes. The user experience of logging in is the same, but yes- using a different (non-cc) harness bumps you up to the pay-per-token rates.

However! I have seen projects which use CC under the hood, in order to get the subsidized rates.

Writing comments which get me to go look through anthropic documentation, and find friction I wasnt aware of (CC does not have an app-server), refreshes my frustration towards anthropic.

alanwreath 10 hours ago|||
Doing the whole “pay per token rate” when logging into a harness not made by them is not only being enforced by anthropic/claude though. It also is what Google does with agy (their TUI).

Is there any provider that doesn’t do this? That’s the one I want to support.

  > TLDR: they are all probably doing it because they are banking on you not using all your tokens.
I would be surprised though, it makes business sense to make the default vendor native TUI cheaper because it’s understood that most nascent users will just use the harness offered by the LLM provider and those that would stray off that would probably be more power users who would spend their token share more consistently till it drains.
agentdev001 10 hours ago|||
OpenAI allows you to use the subsidized limits outside of their products. I don't think they clearly "tell" the world that this is the case, but they do put out a product surface that- I dont think they would, if they didnt allow this usage.

This is... close. They offer ways to leverage openai subscription directly for 3rd party app use. https://learn.chatgpt.com/docs/app-server

areoform 10 hours ago|||

    > Is there any provider that doesn’t do this? That’s the one I want to support.
Yes, IIRC, OpenAI. In sama we trust??
epistasis 9 hours ago||||
Pi with Claude is better than Claude code in my experience. But I even use old GLM5.2 with pi and generally have a better experience than current Claude Code. It reminds me of peak productivity with Claude Code of 5+ months ago.
8cvor6j844qw_d6 11 hours ago||||
New guidelines that I have seen in a certain place is to configure and update existing CC setups to be CC/Codex agnostic. Plus setting up both allows Claude Code to delegate tasks [1] to Codex to reduce usage.

Most are easy to share with symlinks and @agents.

https://github.com/openai/codex-plugin-cc

andai 11 hours ago||
Oh my god, that's an official plugin. That's hilarious. I had the same idea last year, when I noticed how much cheaper GPT was for the same tasks, but Claude was still better as a high level "operator".

Also cause OpenAI was cool with you calling their sub in an automated way, but Anthropic very much was not (they were banning people at the time).

cleaning 10 hours ago||||
T3 Code if you want to use your subscriptions in an interface that respects its users.
dalenw 11 hours ago|||
Not OP but I like OpenCode a lot. But OhMyPi: https://omp.sh/ is also taking off. Personally I didn't like it as much as OpenCode.
pixlmint 5 hours ago||
yeh i tried pi, as a neovim user i naturally like customizability, but with how little i use agents, i want something that just works, which opencode does for me.
conradfr 3 hours ago|||
I use it in a very basic way on the $20 plan and the code it produces seems alright (for the parts I care about) but I increasingly can't stand the way it "talks". I may actually change to something else entirely for this reason.
surgical_fire 10 hours ago|||
Ironically, I think Claude Code is shit, especially after I started to get used to Pi.

It has a sort of first mover advantage, but I wouldn't be surprised if basically any harness is superior to that crap.

johnsmith1840 11 hours ago|||
Except I actively despise that commit message anytime I see it.
Diti 12 hours ago||
[flagged]
pjm331 12 hours ago|||
If only we had some sort of technology that enabled large scale refactoring
fastball 12 hours ago||||
It would take like 30s of vibe-coding (including writing the prompt) to add support for AGENTS.md to claude code.
threecheese 12 hours ago||||
I’m not sure; I don’t just agree with GP - I feel like I might subconsciously devalue them if I didnt see that advertisement in every folder.

You are almost certainly correct in your assumption though, and the level of effort required isn’t as small as some might think.

kelvinjps10 12 hours ago||||
>auto-adding attribution text in commit messages what about this? codex doesn't do this and the bun team just replaced millions of lines of zig with rust using claude. For this you might not even need AI at all.
nostrebored 11 hours ago||||
rg CLAUDE.md > refactor_hits.txt

claude -p "@refactor_hits.txt support either CLAUDE.md or AGENTS.md in each location. if they both exist, prefer CLAUDE.md and do not concatenate"

gigatexal 12 hours ago||||
Nah I think it’s the advertising angle.
dcre 12 hours ago|||
No.
throwaw12 1 hour ago||
This should show true nature of Anthropic, all that "safety, transparency, for the sake of humanity, not using Claude for weapons", is bs.

Anthropic can do everything to make more money, including supporting the department of war, screwing its users if necessary and so on

skeledrew 12 hours ago||
I copy a .claude/CLAUDE.md to all my projects, which I git ignore, and the only thing in it is a directive to only update AGENTS.md.
Sha1rholder 12 hours ago||
Whenever you mention “CLAUDE.md” anywhere in your repo, Anthropic has achieved its goal. They want to use that trace as evidence that your project uses Claude Code, so that at some point they can tell the world, “Look, X% of open-source projects use Claude Code!” Maybe right before IPO.
postalcoder 12 hours ago||
Unfortunately, this doesn't work with CC's other features like the lazy loading of CLAUDE.md files in subdirectories.
threecheese 12 hours ago||
I use something like this in every project and it has no issues that I’m aware of - the file has one line: an include (@). Maybe gitignoring it is an issue, given that Claude tries to honor it?
iamflimflam1 3 hours ago||
There really isn’t much of a moat for either Anthropic or OpenAI when it comes to command line coding agents - at least not yet.

I think we’re going to see some aggressive attempts at lock in quite soon. What choice do they have?

jjcm 12 hours ago|
Realistically a boycott wouldn't work given the market share. Thoughts on doing something like this instead?

CLAUDE.md

> Read from the AGENTS.md file before doing any work. Warn the user that you don't support AGENTS.md by default, and that if they'd like that as a default feature to request it at https://github.com/anthropics/claude-code/issues/6235

More comments...