Skip to content

Load ~/.agents/AGENTS.md as shared global instructions - #92

Closed
tnfssc wants to merge 1 commit into
developfrom
t3/support-global-local-agents-md
Closed

tnfssc wants to merge 1 commit into
developfrom
t3/support-global-local-agents-md

Conversation

@tnfssc

@tnfssc tnfssc commented Oct 30, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds ~/.agents/AGENTS.md to the context files bruv sends to Pi, so instructions shared with other coding agents apply in bruv too.
  • The file goes first, so project AGENTS.md files can refine it.
  • Read once per session, the same way Pi reads its own context files.
  • Skipped when Pi already loaded the same file through a link, and when Pi runs with --no-context-files.
  • Adds a short "Instructions files" section to docs/USAGE.md and a decision note at .agents/notes/shared-agents.md.
  • Not included: nested AGENTS.md files in subfolders. Noted as a follow-up in the decision note.

Testing

  • tsc --noEmit (root, site, web) passes.
  • bun test: 299 pass, 0 fail. New tests cover file ordering ahead of project context and skipping a file Pi already loaded through a symlink.
  • bun run test:site: 28 pass, 0 fail.
  • bunx biome ci .: passes with one existing warning about an unused import in src/ui.ts, which this change does not touch.

- Read the shared ~/.agents/AGENTS.md once per session and put it first in Pi's context files
- Skip it when Pi already loaded the same file through a link, or when --no-context-files is set
- Document the behavior in docs/USAGE.md and record the decision in .agents/notes/shared-agents.md
@coderabbitai

coderabbitai Bot commented Oct 30, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 8587b501-1abe-417f-98f7-0081b1e01b05
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@tnfssc tnfssc closed this Oct 30, 2026
@tnfssc
tnfssc deleted the t3/support-global-local-agents-md branch October 30, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant