Skip to content

feat: support AGENTS.override.md personal context override (port of pi#7681) - #80682

Merged
teknium1 merged 1 commit into
mainfrom
pi-port/agents-override-md
Aug 17, 2026
Merged

feat: support AGENTS.override.md personal context override (port of pi#7681)#80682
teknium1 merged 1 commit into
mainfrom
pi-port/agents-override-md

Conversation

@teknium1

@teknium1 teknium1 commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Summary

AGENTS.override.md now overrides AGENTS.md as project context — keep a personal, typically-gitignored override next to committed project instructions without editing the tracked file.

Port of earendil-works/pi#7681, adapted to Hermes' two context-loading paths.

Changes

  • agent/prompt_builder.py: _load_agents_md() checks AGENTS.override.md first (startup project context; .hermes.md still wins overall)
  • agent/subdirectory_hints.py: AGENTS.override.md added at the top of _HINT_FILENAMES (progressive subdirectory discovery, first-match-wins per directory)
  • website/docs/user-guide/features/context-files.md: priority table + override explanation
  • Tests: 4 new prompt_builder cases + 1 subdirectory-hints case

Validation

Result
tests/agent/test_subdirectory_hints.py + test_prompt_builder.py 85 passed

Infographic

AGENTS.override.md priority

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

૮ >ﻌ< ა ci review

ran on e6aabe6 — Port from earendil-works/pi#7681: support AGENTS.override.md

⚠️ Warnings

CI timings · View report · View job

Wall time 17m35s vs 8m (+119.8%). 12 job(s) slower, 11 faster, 2 unchanged.

  • Python tests / Run tests slice 11/12: +63.0s
  • Python tests / Run tests slice 7/12: -42.0s
  • Python tests / Run tests slice 12/12: -41.0s
  • Python tests / Run tests slice 4/12: -35.0s
  • Python tests / Run tests slice 1/12: +35.0s

OSV vulnerability scan · View job

5 known vulnerabilities found in pinned dependencies.

How to fix:

Review the findings in the Security tab. Update the affected dependencies if a patched version is available.

@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint labels Aug 7, 2026
…override

AGENTS.override.md now takes priority over AGENTS.md in both startup
project-context loading (prompt_builder) and progressive subdirectory
hint discovery (subdirectory_hints). Lets developers keep a personal,
typically-gitignored override next to committed project instructions
without editing the tracked file.
@teknium1
teknium1 force-pushed the pi-port/agents-override-md branch from 41efb0a to e6aabe6 Compare August 17, 2026 02:54
@teknium1
teknium1 merged commit a8d5e16 into main Aug 17, 2026
45 checks passed
@teknium1
teknium1 deleted the pi-port/agents-override-md branch August 17, 2026 05:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint P3 Low — cosmetic, nice to have type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants