How do I install the Greptile skill?

Run npx skillmds@latest add johnalbertini14-glitch/greptile in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Greptile safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Greptile?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Greptile free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Greptile?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Greptile by johnalbertini14-glitch — Agent Skill

Name: Greptile
Rating: 4.666666666666667 (3 reviews)
Author: johnalbertini14-glitch

Greptile

Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code patterns, indexing repos for Greptile review, or checking Greptile index status. Requires GREPTILE_TOKEN and a GitHub/GitLab token.

File contents

Greptile Skill

Query and manage Greptile-indexed repositories via the REST API.

Setup

Required environment variables:

GREPTILE_TOKEN — Greptile API token (from https://app.greptile.com)
GITHUB_TOKEN — GitHub PAT with repo access (alternatively set GREPTILE_GITHUB_TOKEN, or authenticate via gh auth login — the script falls back to gh auth token)

Commands

All commands use scripts/greptile.sh (resolve path relative to this skill directory).

Index a repository

scripts/greptile.sh index owner/repo [branch] [--remote github|gitlab] [--no-reload] [--no-notify]

Default branch: main. Use --no-reload to skip re-indexing if already processed.

Check index status

scripts/greptile.sh status owner/repo [branch] [--remote github|gitlab]

Returns: status (completed/processing/failed), filesProcessed, numFiles.

Query a codebase (AI answer + sources)

scripts/greptile.sh query owner/repo [branch] "How does auth work?" [--genius] [--remote github|gitlab]

--genius — slower but smarter analysis (good for PR reviews, architecture questions)
Returns: AI-generated answer + source file references with line numbers

Search a codebase (sources only, no AI answer)

scripts/greptile.sh search owner/repo [branch] "payment processing" [--remote github|gitlab]

Returns: ranked list of relevant files, functions, and snippets with line numbers.

Tips

Always index a repo before querying/searching it. Check status to confirm indexing is complete.
Use query --genius for complex questions (architecture, PR review context, cross-file analysis).
Use search when you just need file locations without an AI explanation.
For GitLab repos, pass --remote gitlab.
Pipe output through jq for formatting: scripts/greptile.sh query ... | jq .
Multi-repo queries: not supported by the wrapper; use the API directly with multiple repositories in the body.

---name: greptiledescription: Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code patterns, indexing repos for Greptile review, or checking Greptile index status. Requires GREPTILE_TOKEN and a GitHub/GitLab token.--- # Greptile Skill Query and manage Greptile-indexed repositories via the REST API. ## Setup Required environment variables: - `GREPTILE_TOKEN` — Greptile API token (from https://app.greptile.com) - `GITHUB_TOKEN` — GitHub PAT with repo access (alternatively set `GREPTILE_GITHUB_TOKEN`, or authenticate via `gh auth login` — the script falls back to `gh auth token`) ## Commands All commands use `scripts/greptile.sh` (resolve path relative to this skill directory). ### Index a repository ```bash scripts/greptile.sh index owner/repo [branch] [--remote github|gitlab] [--no-reload] [--no-notify] ``` Default branch: `main`. Use `--no-reload` to skip re-indexing if already processed. ### Check index status ```bash scripts/greptile.sh status owner/repo [branch] [--remote github|gitlab] ``` Returns: `status` (completed/processing/failed), `filesProcessed`, `numFiles`. ### Query a codebase (AI answer + sources) ```bash scripts/greptile.sh query owner/repo [branch] "How does auth work?" [--genius] [--remote github|gitlab] ``` - `--genius` — slower but smarter analysis (good for PR reviews, architecture questions) - Returns: AI-generated answer + source file references with line numbers ### Search a codebase (sources only, no AI answer) ```bash scripts/greptile.sh search owner/repo [branch] "payment processing" [--remote github|gitlab] ``` Returns: ranked list of relevant files, functions, and snippets with line numbers. ## Tips - Always `index` a repo before querying/searching it. Check `status` to confirm indexing is complete. - Use `query --genius` for complex questions (architecture, PR review context, cross-file analysis). - Use `search` when you just need file locations without an AI explanation. - For GitLab repos, pass `--remote gitlab`. - Pipe output through `jq` for formatting: `scripts/greptile.sh query ... | jq .` - Multi-repo queries: not supported by the wrapper; use the API directly with multiple repositories in the body.

Frequently asked questions