How to confirm which instruction files were loaded during startup? #6863

Closed
opened 2026-02-16 18:05:27 -05:00 by yindo · 3 comments
Owner

Originally created by @cogni-ai-ee on GitHub (Jan 19, 2026).

Originally assigned to: @jayair on GitHub.

Question

I'm using anomalyco/opencode/github@latest, but it's not clear which instructions files are loaded at the runtime.

The output starts with like:

Sending message to opencode...
|  Read     {"filePath":".github/skills/pre-commit/SKILL.md"}
|  Glob     {"pattern":".pre-commit-config.yaml"}

but it doesn't tell me whether AGENTS.md file was loaded or not (I've multiple of them in the project, but I think they're not followed). I've added it to instructions in .opencode/opencode.jsonc, but it's still not shown.

If it's loaded, maybe we could have some extra option to increase verbose mode (or variable) for the action?

Originally created by @cogni-ai-ee on GitHub (Jan 19, 2026). Originally assigned to: @jayair on GitHub. ### Question I'm using `anomalyco/opencode/github@latest`, but it's not clear which instructions files are loaded at the runtime. The output starts with like: ``` Sending message to opencode... | Read {"filePath":".github/skills/pre-commit/SKILL.md"} | Glob {"pattern":".pre-commit-config.yaml"} ``` but it doesn't tell me whether AGENTS.md file was loaded or not (I've multiple of them in the project, but I think they're not followed). I've added it to instructions in `.opencode/opencode.jsonc`, but it's still not shown. If it's loaded, maybe we could have some extra option to increase verbose mode (or variable) for the action?
yindo added the docs label 2026-02-16 18:05:27 -05:00
yindo closed this issue 2026-02-16 18:05:27 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Jan 19, 2026):

This issue might be a duplicate of existing issues. Please check:

  • #7679: [FEATURE]: Add slash command to show active instruction file paths in a session - Directly addresses the request to see which instruction files are loaded
  • #4758: Issue Report: Custom instruction files in opencode.jsonc not being loaded - Related to verifying which instruction files are actually being loaded
  • #2936: [FEATURE] Peek at the CTX - Files Loaded & Stats - Broader feature request to see what's loaded into context and their sizes

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Jan 19, 2026): This issue might be a duplicate of existing issues. Please check: - #7679: [FEATURE]: Add slash command to show active instruction file paths in a session - Directly addresses the request to see which instruction files are loaded - #4758: Issue Report: Custom instruction files in `opencode.jsonc` not being loaded - Related to verifying which instruction files are actually being loaded - #2936: [FEATURE] Peek at the CTX - Files Loaded & Stats - Broader feature request to see what's loaded into context and their sizes Feel free to ignore if none of these address your specific case.
Author
Owner

@R44VC0RP commented on GitHub (Jan 20, 2026):

Thanks for the question! You're right that there's currently no way to see which instruction files were loaded at runtime.

How instruction loading works

OpenCode loads instruction files in this order:

  1. Local rule files (searched upward from your working directory): AGENTS.md, CLAUDE.md, CONTEXT.md
  2. Global rule files: ~/.config/opencode/AGENTS.md
  3. Custom instructions from opencode.jsonc: files specified in the instructions array

Each file's content is prefixed internally with "Instructions from: <path>", but this isn't currently exposed to users.

Feature request for visibility

We have an open feature request and PR for exactly this:

  • #7679: Add /instructions slash command to show loaded files
  • #7678: PR implementing this (for TUI)

For the GitHub Action specifically, adding a verbose/debug mode to show loaded instructions would be a good enhancement - that could be tracked as a follow-up to #7679.

I'm going to close this as it overlaps with #7679. Feel free to add a comment there requesting verbose output for the GitHub Action!

@R44VC0RP commented on GitHub (Jan 20, 2026): Thanks for the question! You're right that there's currently no way to see which instruction files were loaded at runtime. ### How instruction loading works OpenCode loads instruction files in this order: 1. **Local rule files** (searched upward from your working directory): `AGENTS.md`, `CLAUDE.md`, `CONTEXT.md` 2. **Global rule files**: `~/.config/opencode/AGENTS.md` 3. **Custom instructions** from `opencode.jsonc`: files specified in the `instructions` array Each file's content is prefixed internally with `"Instructions from: <path>"`, but this isn't currently exposed to users. ### Feature request for visibility We have an open feature request and PR for exactly this: - **#7679**: Add `/instructions` slash command to show loaded files - **#7678**: PR implementing this (for TUI) For the GitHub Action specifically, adding a verbose/debug mode to show loaded instructions would be a good enhancement - that could be tracked as a follow-up to #7679. I'm going to close this as it overlaps with #7679. Feel free to add a comment there requesting verbose output for the GitHub Action!
Author
Owner

@R44VC0RP commented on GitHub (Jan 20, 2026):

Closing as duplicate of #7679

@R44VC0RP commented on GitHub (Jan 20, 2026): Closing as duplicate of #7679
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#6863