run-llama

Fs Explorer

Name: Fs Explorer
Author: run-llama

Development community

SOURCE https://github.com/run-llama/fs-explorer

Description

CLI agent to explore file system, powered by Gemini 3 Flash

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

fs-explorer

CLI agent that helps you explore a directory and its content (it can also read PDF/PPTX/DOCX/XLSX files!).

Installation and Usage

Clone this repository:

git clone https://github.com/run-llama/fs-explorer
cd fs-explorer

Install locally:

uv pip install .

Export a Google API key (must have access to EAP models):

export GOOGLE_API_KEY="..."

Run:

explore run --task "Within the data/ directory, can you help e find the PDF file that contains an order or a complaint, and, once you found them, ask me which one I would like you to summarize"

Evaluation against traditional RAG

In the [`packages`](./packages/) directory we have two packages:

**rag-starterkit**: a traditional RAG application implementing hybrid search. (More in the dedicated README).
**eval-framework**: a simple evaluation framework that produces LLM-as-a-judge-based evals along with collecting time-, tool usage- and file-search-based statistics. Find out how to run the evaluation and collect statistics in the dedicated README.
**cache-arxiv**: a utility package to cache arXiv papers for larger scale experiments.

Find the evaluation guide [here](./packages/eval-framework/README.md).