← Back to Skills Marketplace
iahmadzain

Greptile

by iAhmadZain · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
723
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install greptile
Description
Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code pattern...
README (SKILL.md)

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.
Usage Guidance
This skill appears to implement the Greptile API as advertised, but it requires you to provide or allow access to a Git host token which the wrapper will forward to api.greptile.com. Only proceed if you trust that third-party service. If you decide to use it: (1) create a GitHub PAT with the minimum scopes needed (avoid using a personal/all-access token), (2) avoid using a token that grants org- or account-level admin access, (3) consider authenticating via a temporary token or using a test repository first, (4) be aware the script will read 'gh auth token' if you don't supply a token environment variable (so local gh CLI credentials can be used), and (5) note the script calls python3 but python3 is not declared as a required binary — ensure python3 is available in your environment. If you cannot verify greptile.com's provenance or privacy policy, treat this as high-risk and avoid providing high-privilege credentials.
Capability Analysis
Type: OpenClaw Skill Name: greptile Version: 1.0.1 The skill is designed to interact with the Greptile API, requiring `GREPTILE_TOKEN` and `GITHUB_TOKEN` (or `GREPTILE_GITHUB_TOKEN`) as environment variables. The `scripts/greptile.sh` script uses `curl` to send these tokens to the legitimate `api.greptile.com` endpoint, consistent with its stated purpose. Input arguments for JSON payloads are safely handled using `jq --arg` and URL encoding is performed with `python3 urllib.parse.quote`, mitigating common shell injection risks. There is no evidence of data exfiltration to unauthorized domains, persistence mechanisms, obfuscation, or malicious prompt injection attempts in `SKILL.md`.
Capability Assessment
ℹ Purpose & Capability
The name/description match the included script and instructions: the skill queries and manages Greptile-indexed repos and requires a GREPTILE_TOKEN plus a GitHub/GitLab token. Asking for a Git host token is plausible because the script forwards it to the Greptile API so Greptile can access private repos. However the package has no homepage/source and the publisher identity is unknown, which reduces provenance confidence.
✓ Instruction Scope
SKILL.md confines runtime actions to calling scripts/greptile.sh which performs API calls (index/status/query/search) against https://api.greptile.com/v2. The instructions do not attempt to read unrelated files or exfiltrate arbitrary local data. They do, however, instruct the wrapper to obtain a GitHub token via 'gh auth token' if an env var is not provided (this reads local gh CLI auth state).
✓ Install Mechanism
No install spec — instruction-only plus a small script shipped with the skill. Nothing is downloaded or written to disk during installation by the registry, so install risk is low.
⚠ Credentials
The script requires GREPTILE_TOKEN and a Git host token (GITHUB_TOKEN or GREPTILE_GITHUB_TOKEN) and forwards the Git token to api.greptile.com via the 'X-GitHub-Token' header. Sending your GitHub PAT to a third-party API is a high-privilege action; it may be justified for indexing private repos, but you should only provide a minimal-scope token and only if you trust greptile.com. The script also attempts to call 'gh auth token' (reads local gh CLI credentials) — GH CLI access is declared as a required binary, but the script uses python3 for URL quoting while python3 is not listed in the declared required binaries (runtime mismatch).
✓ Persistence & Privilege
The skill is not always-enabled and does not request persistent system-wide modifications. It does not modify other skills or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install greptile
  3. After installation, invoke the skill by name or use /greptile
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: declare all runtime requirements (GITHUB_TOKEN, gh CLI) in metadata to match SKILL.md docs
v1.0.0
Initial release: index, status, query, and search commands for Greptile API
Metadata
Slug greptile
Version 1.0.1
License —
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Greptile?

Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code pattern... It is an AI Agent Skill for Claude Code / OpenClaw, with 723 downloads so far.

How do I install Greptile?

Run "/install greptile" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Greptile free?

Yes, Greptile is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Greptile support?

Greptile is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Greptile?

It is built and maintained by iAhmadZain (@iahmadzain); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments