Skip to content

Document repo-memory feature#5745

Merged
pelikhan merged 4 commits intomainfrom
copilot/document-repo-memory
Dec 7, 2025
Merged

Document repo-memory feature#5745
pelikhan merged 4 commits intomainfrom
copilot/document-repo-memory

Conversation

Copy link
Contributor

Copilot AI commented Dec 7, 2025

Added comprehensive documentation for the repo-memory tool, which provides Git-based persistent storage for agentic workflows with unlimited retention (vs cache-memory's 7-day limit).

Changes

  • Renamed docs/src/content/docs/reference/cache-memory.md to docs/src/content/docs/reference/memory.md to cover both cache-memory and repo-memory under unified "Memory" page
  • Updated link in docs/astro.config.mjs from /reference/cache-memory/ to /reference/memory/
  • Added complete repo-memory documentation (~300 lines):
    • Configuration options: branch-name, target-repo, file-glob, max-file-size, max-file-count, description, create-orphan
    • Multiple memory locations using array notation
    • Git integration behavior (branch creation, commit/push, merge conflict resolution with -X ours)
    • Comparison table: cache-memory vs repo-memory
    • Best practices, troubleshooting, security considerations
    • Examples including cross-repository memory storage

Example Usage

---
tools:
  repo-memory:
    - id: insights
      branch-name: memory/insights
      description: "Long-term patterns and trends"
      file-glob: ["*.md"]
      max-file-size: 1048576  # 1MB
    - id: state
      branch-name: memory/state
      description: "Current state and context"
      file-glob: ["*.json"]
---

Memory stored at /tmp/gh-aw/repo-memory-{id}/memory/{id}/ with automatic commit/push after workflow completion.

Warning

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using Astro Starlight and GitHub Docs voice

Original prompt

Document repo-memory

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using Astro Starlight and GitHub Docs voice


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits December 7, 2025 13:23
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add documentation for repo memory Document repo-memory feature Dec 7, 2025
Copilot AI requested a review from pelikhan December 7, 2025 13:33
@pelikhan
Copy link
Contributor

pelikhan commented Dec 7, 2025

@copilot rename "cache-memory.md" to "memory.md", update the links

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Dec 7, 2025

@copilot rename "cache-memory.md" to "memory.md", update the links

Done in f2bcc4f. Renamed cache-memory.md to memory.md and updated the link in astro.config.mjs from /reference/cache-memory/ to /reference/memory/. Build verified successfully with all internal links valid.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.11.1/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

@pelikhan pelikhan marked this pull request as ready for review December 7, 2025 13:43
@pelikhan pelikhan merged commit d9a7972 into main Dec 7, 2025
9 checks passed
@pelikhan pelikhan deleted the copilot/document-repo-memory branch December 7, 2025 13:43
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.

2 participants