← Back to Skills Marketplace
File Indexer
by
LookUpMark
· GitHub ↗
· v1.2.0
· MIT-0
157
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install lookupmark-file-indexer
Description
Fast filesystem catalog for finding files by name, date, type, or size. Indexes metadata only (no content). Uses SQLite for instant lookups. Triggers on "fin...
README (SKILL.md)
File Indexer
Fast metadata-based file catalog. No content indexed — only filenames, sizes, dates, and extensions.
Usage
# Build/rebuild the index (run once, or periodically)
python3 scripts/indexer.py --rebuild
# Update incrementally (fast — adds new, removes deleted)
python3 scripts/indexer.py --update
# Search by filename
python3 scripts/indexer.py --search "budget"
# Filter by extension
python3 scripts/indexer.py --search "report" --ext .pdf
# Filter by size
python3 scripts/indexer.py --search "" --min-size 10485760 # > 10MB
# Filter by date
python3 scripts/indexer.py --search "" --after 2026-03-01
# Index statistics
python3 scripts/indexer.py --stats
Security
- ALLOWED_ROOTS: Only
~/Documentiand~/Scaricati— same as RAG - BLOCKED_DIRS:
.ssh,.gnupg,.config,credentials,.local,.cache,.Trash - Zero content: Only metadata (name, size, date, extension) — never reads file contents
- No secrets: Paths to sensitive dirs are never indexed
- Local only: SQLite DB at
~/.local/share/file-indexer/catalog.db
What Gets Indexed
| Yes | No |
|---|---|
| Filename | File contents |
| Extension | Full text |
| Size | Embeddings |
| Modified date | Preview |
| Directory path | Thumbnails |
Automation
Add to cron or heartbeat for periodic updates:
python3 scripts/indexer.py --update
Works well alongside local-rag: use this for "where is that file?" and RAG for "what does that file say?"
Usage Guidance
This skill appears coherent and local-only, but check these points before installing: (1) It writes a SQLite DB and creates a .bak under ~/.local/share/file-indexer — if you are uncomfortable with that file, don't install. (2) The allowed roots are ~/Documenti and ~/Scaricati (Italian names) — verify these match the directories you want indexed (e.g., ~/Documents/Downloads). (3) Symlinks inside allowed roots may cause metadata about their targets to be indexed even if those targets live outside the allowed roots; avoid symlinks to sensitive locations. (4) The script does not read file contents or send data over network, but you should still review the included script before running it and run it with your normal least-privilege practices (or in a sandbox) if you have sensitive files. If you want stricter guarantees, change ALLOWED_ROOTS, BLOCKED_DIRS, or run the script manually to inspect behavior before enabling automation.
Capability Analysis
Type: OpenClaw Skill
Name: lookupmark-file-indexer
Version: 1.2.0
The file-indexer skill is a legitimate utility for indexing and searching file metadata (names, sizes, dates) within specific user directories (~/Documenti and ~/Scaricati). The script (scripts/indexer.py) includes explicit security measures, such as a blacklist for sensitive directories like .ssh and .gnupg, and it strictly avoids reading file contents, focusing only on filesystem metadata stored in a local SQLite database.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md usage examples, and the included scripts/indexer.py all implement a metadata-only file indexer that writes a local SQLite DB under ~/.local/share/file-indexer. Required capabilities are minimal and aligned with the stated purpose.
Instruction Scope
SKILL.md instructs running the bundled Python script to rebuild/update/search the index; the script only uses os.walk and os.stat to collect filename, size, date, extension and writes to a local DB. Note: the code follows symlinks when calling os.stat on files (os.stat follows symlinks), so a symlink inside an allowed root that points to a sensitive file elsewhere could cause metadata about that target to be indexed. Also the script creates a local .bak backup of the DB when rebuilding.
Install Mechanism
No install spec is provided (instruction-only skill). The runtime relies on the included Python script and the system's python3/sqlite3; nothing is downloaded or written outside the user's home directory except the DB and its backup. This is a low-risk install posture.
Credentials
The skill requires no environment variables or external credentials. The local-only DB path and ALLOWED_ROOTS are declared in the code and SKILL.md, so requested permissions are proportionate to its functionality.
Persistence & Privilege
always:false (default) and no elevated privileges are requested. The skill persists a local SQLite DB and backup under the user's home directory; it does not modify other skills or system-wide configurations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lookupmark-file-indexer - After installation, invoke the skill by name or use
/lookupmark-file-indexer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
FTS5 injection sanitization, backup before rebuild
v1.1.0
FTS5 full-text search for instant filename lookup. Rebuild recreates FTS index cleanly.
v1.0.0
Initial release. SQLite metadata catalog. Search by name/ext/size/date. Same security roots as RAG. Zero content indexing.
Metadata
Frequently Asked Questions
What is File Indexer?
Fast filesystem catalog for finding files by name, date, type, or size. Indexes metadata only (no content). Uses SQLite for instant lookups. Triggers on "fin... It is an AI Agent Skill for Claude Code / OpenClaw, with 157 downloads so far.
How do I install File Indexer?
Run "/install lookupmark-file-indexer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is File Indexer free?
Yes, File Indexer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does File Indexer support?
File Indexer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created File Indexer?
It is built and maintained by LookUpMark (@lookupmark); the current version is v1.2.0.
More Skills