Hidden Folders Access

Make Obsidian index hidden root-level folders (names starting with a dot, e.g. .claude, .github) so they show up in the file explorer, the metadata cache, the link graph, and Bases — while keeping the folders hidden on disk so external tools (Claude Code, git, etc.) keep working unchanged.

Key Features

  • Per-folder opt-in: pick exactly which hidden root folders Obsidian should index.
  • Full Obsidian integration: hidden files appear in the file explorer, graph view, search, metadata cache, and Bases.
  • Live updates: creating, modifying, renaming, or deleting files inside an enabled folder updates Obsidian in real time.
  • No on-disk changes: names keep their leading dot, no symlinks, no copies.
  • Clean disable: turning a folder off immediately removes its entries from Obsidian.

Installation

  1. In Obsidian, go to Settings → Community plugins.
  2. Disable Restricted mode if it’s enabled.
  3. Select Browse, search for Hidden Folders Access, install it, then enable it.

You can also browse the catalog on the Obsidian Community website.

Manual installation

If the plugin isn’t listed in the community catalog yet (or you want a specific version):

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into <Vault>/.obsidian/plugins/hidden-folders-access/.
  3. Reload Obsidian and enable Hidden Folders Access in Settings → Community plugins.

BRAT (bleeding edge)

BRAT (Beta Reviewers Auto-update Tool) installs plugins straight from a GitHub repo and keeps them updated automatically. Use this if you want the latest commits — things might break.

  1. Install Obsidian42 - BRAT from Settings → Community plugins → Browse and enable it.
  2. Run BRAT: Add a beta plugin for testing from the command palette.
  3. Paste https://github.com/dsebastien/obsidian-hidden-folders-access.
  4. Select the latest version and confirm.
  5. Enable Hidden Folders Access in Settings → Community plugins.

Quick Start

  1. Install and enable the plugin (see above).
  2. Open Settings → Hidden Folders Access.
  3. Toggle on the folders you want Obsidian to index.
  4. The files appear in the explorer and become usable from Bases, Dataview, search, etc.

When to Use It

  • You keep AI agent configuration in .claude/ and want to browse / query it from Obsidian Bases.
  • You want to include .github/, .obsidian-templates/, or other hidden folders in the vault without renaming them.
  • You already manage dotted folders with external tools and don’t want Obsidian to rename or duplicate them.

About

Created by Sébastien Dubois. Support development via Buy Me a Coffee.

My other Obsidian plugins

Plugin What it does
Agentic Resource Discovery Server Local-first Agentic Resource Discovery publisher and registry that serves your AI skills and tools to agents over a local HTTP and MCP server
Book Exporter Export books (one manifest note + linked chapter notes) to EPUB and PDF via Pandoc
Bookshelf Base Display your notes as a visual bookshelf via a custom Bases view
Dataview Serializer Serialize Dataview queries to Markdown, and keep the Markdown representation up to date
Expander Replace variables across your vault using HTML comment markers. Supports static values and dynamic functions
Ghost Publish Publish your vault notes to a Ghost blog with configurable presets for tags, newsletters, and frontmatter conventions
Graph Explorer Base View A custom Bases view that renders notes as an interactive force-directed graph with explored/unexplored tracking
Journal Bases Custom Base views for journaling and periodic reviews
Kanban Action Planner Render your notes as configurable Kanban boards and calendars inside Bases, with statuses, ordering, relationships, and scheduling
Life Tracker Capture and visualize the data that matters in your life
Note Village A 2D pixel art village where your notes become villagers you can explore and chat with using AI
Obsidian Starter Kit Adds strong typing support and powerful automation support for notes
Remarkable Synchronizer Connect to the reMarkable cloud, list, download, and sync notebook pages as images
Replicate Use AI models with ease via the Replicate.com integration
REST and MCP server Exposes CLI commands as RESTful API endpoints and an MCP server for AI tool integration
Time Machine Browse, compare, and restore previous versions of your notes using built-in file-recovery snapshots
Transcriber Transcribe images to markdown using Ollama vision models
Typefully Publish social media posts with ease using the Typefully integration
Update Time Automatically update front matter to include creation and last update times

Everything I build is documented in my newsletter and on my YouTube channel.

News & support

To stay up to date about this plugin, Obsidian in general, Personal Knowledge Management and note-taking:

If this plugin is useful to you, here are the best ways to support my work ❤️: