github / github/copilot-cli

Feature request: reload .github/instructions mid-session (long-running sessions never pick up instruction updates)

Open
#4,508 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area:context-memory
Dominant language
Shell
Stars
11.2k
Forks
1.9k
Avg merge
14h 16m
Merged PRs (30d)
6

Description

Observed behavior

Custom instructions (.github/instructions/*.instructions.md) are loaded once at session start. A long-running session — kept alive across many compactions over days — never sees any later edits to those files. We measured a session that crossed 200+ compaction boundaries over ~2.5 weeks: the instruction content it held stayed at its boot-time version the whole way, while the on-disk files moved dozens of revisions ahead. Compaction/summarization does not re-read the instruction files, so there is currently no way for updated standing instructions to reach an in-flight session at all.

Why it matters

For anyone using instruction files as living, standing guidance (conventions, safety rules, project state), the effective delivery is boot-only. The longer and more productive a session, the staler its standing instructions — the sessions you care most about are the ones guaranteed to be furthest behind. Restarting the session works but discards its accumulated context, which is exactly what long-running sessions exist to keep.

Ask

Any one of these would resolve it:

  1. An explicit reload command/verb (e.g. /reload-instructions) that re-reads the instruction files into the live session, or
  2. Automatic re-read of instruction files at each compaction boundary (a natural moment, since context is being rebuilt anyway), or
  3. A documented statement that instructions are boot-only, so users can design around it deliberately (e.g., scheduled restarts).
Environment

Copilot CLI on Windows, long-lived sessions resumed across days, instruction files under .github/instructions/ in the working directory.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing a long-running Copilot CLI session with files under .github/instructions/*.instructions.md, then compare instruction content before and after compaction. Trace the initial instruction load and compaction/summarization behavior; done means updated instructions reach the live session or the boot-only behavior is clearly documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, shell
Domain
cli, developer-experience
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.