← 返回 Skills 市场
iahmadzain

Greptile

作者 iAhmadZain · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
723
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install greptile
功能描述
Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code pattern...
使用说明 (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.
安全使用建议
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.
功能分析
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`.
能力评估
ℹ 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.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install greptile
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /greptile 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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
元数据
Slug greptile
版本 1.0.1
许可证 —
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Greptile 是什么？

Query, search, and manage repositories indexed by Greptile (AI codebase intelligence). Use when asking questions about a codebase, searching for code pattern... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 723 次。

如何安装 Greptile？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install greptile」即可一键安装，无需额外配置。

Greptile 是免费的吗？

是的，Greptile 完全免费（开源免费），可自由下载、安装和使用。

Greptile 支持哪些平台？

Greptile 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Greptile？

由 iAhmadZain（@iahmadzain）开发并维护，当前版本 v1.0.1。

推荐 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.
⬇ 191113 · 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

💬 留言讨论