Skip to content

fix(core): handle EISDIR error when GEMINI.md is a directory#17840

Closed
mag123c wants to merge 1 commit intogoogle-gemini:mainfrom
mag123c:fix/16282-handle-eisdir-gemini-md
Closed

fix(core): handle EISDIR error when GEMINI.md is a directory#17840
mag123c wants to merge 1 commit intogoogle-gemini:mainfrom
mag123c:fix/16282-handle-eisdir-gemini-md

Conversation

@mag123c
Copy link
Contributor

@mag123c mag123c commented Jan 29, 2026

Summary

Skip directories named GEMINI.md during memory discovery instead of logging misleading warnings, preventing EISDIR errors.

Details

  • Add EISDIR error code check in readGeminiMdFiles() catch block
  • Skip directories silently. only log in debug mode.
  • Add test case for GEMINI.md as directory secnario.

Related Issues

Fixes #16282

How to Validate

  1. Create a directory named GEMINI.md in a project root.
  2. Run npm start
  3. Type /about or any command that triggers memory discovery.
  4. Verify no ESIDIR error or warning is logged

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

Skip directories named GEMINI.md during memory discovery instead of logging misleading warnings.
This prevents EISDIR errors when a directory exists where a GEMINI.md file is expected.

# Fixes google-gemini#16282
@mag123c mag123c requested a review from a team as a code owner January 29, 2026 02:44
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @mag123c, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the robustness of the memory discovery mechanism by gracefully handling a specific file system edge case. Previously, if a directory was inadvertently named GEMINI.md, it would lead to an EISDIR error and potentially misleading warnings. The changes ensure that such directories are now silently ignored, improving the stability and user experience of the core application.

Highlights

  • Error Handling: Implemented specific handling for EISDIR errors that occur when GEMINI.md is encountered as a directory instead of a file during memory discovery.
  • Directory Skipping: Directories named GEMINI.md are now silently skipped during the memory discovery process, preventing crashes or misleading warnings.
  • Logging Improvement: A debug log message is now issued when a GEMINI.md directory is skipped, providing better insight in debug mode without cluttering production logs.
  • Test Coverage: A new test case has been added to ensure that GEMINI.md directories are correctly skipped without generating warnings.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request effectively addresses the EISDIR error that occurs when GEMINI.md is a directory by skipping it during memory discovery. The added test case is a great addition. My review includes a suggestion to improve the accuracy of the fileCount returned by the memory discovery functions, as the current implementation can be misleading when directories are skipped. I've also suggested strengthening the new test to assert this corrected behavior.

DEFAULT_FOLDER_TRUST,
);

expect(result.memoryContent).toBe('');
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

To make this test more robust and ensure the fileCount is accurate, please also assert that result.fileCount is 0. This verifies that skipped directories are not counted as loaded files. This change is related to the suggested fix in memoryDiscovery.ts to calculate fileCount more accurately.

expect(result.memoryContent).toBe('');
expect(result.fileCount).toBe(0);

Comment on lines +277 to +281
if (errorCode === 'EISDIR') {
if (debugMode) {
logger.debug(`Skipping directory at ${filePath}`);
}
return { filePath, content: null };
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

Returning null content here correctly handles the EISDIR error without warnings. However, this reveals an issue in loadServerHierarchicalMemory where fileCount becomes misleading. It's calculated from the total number of paths discovered, including directories that are skipped here. This means the UI might report '1 file loaded' when it was a directory and no content was actually loaded.

To ensure accuracy, fileCount should reflect the number of successfully read files. I recommend updating loadServerHierarchicalMemory to filter for non-null content before counting:

// In loadServerHierarchicalMemory...
const successfullyReadFiles = contentsWithPaths.filter(
  (item) => item.content !== null
);

return {
  memoryContent: combinedInstructions,
  fileCount: successfullyReadFiles.length, // This is more accurate
  filePaths,
};

Since this is outside the current diff, I'm noting it here for you to consider as part of a complete fix.

@gemini-cli
Copy link
Contributor

gemini-cli bot commented Jan 29, 2026

Hi there! Thank you for your contribution to Gemini CLI. We really appreciate the time and effort you've put into this pull request.

To keep our backlog manageable and ensure we're focusing on current priorities, we are closing pull requests that haven't seen maintainer activity for 30 days. Currently, the team is prioritizing work associated with 🔒 maintainer only or help wanted issues.

If you believe this change is still critical, please feel free to comment with updated details. Otherwise, we encourage contributors to focus on open issues labeled as help wanted. Thank you for your understanding!

@gemini-cli gemini-cli bot closed this Jan 29, 2026
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.

[Core] Handle EISDIR error when GEMINI.md is a directory during memory discovery

1 participant