greptile

What This Skill Does

The Greptile skill for OpenClaw empowers your AI agent to perform deep, semantic analysis on massive codebases. By integrating directly with the Greptile AI codebase intelligence platform, this skill allows your agent to index repositories, query logic, search for specific patterns, and retrieve context-aware answers from your GitHub or GitLab repositories. Unlike standard grep searches, this skill leverages vector search and LLM-powered synthesis to understand complex architectural questions, such as how authentication flows are implemented or where specific business logic resides across multiple files.

Installation

To integrate this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/iahmadzain/greptile. After installation, ensure you have configured your environment variables. You must provide GREPTILE_TOKEN (acquired from the Greptile dashboard) and a GITHUB_TOKEN or GREPTILE_GITHUB_TOKEN with appropriate repository read permissions. Once configured, the agent can immediately begin indexing your target repositories.

Use Cases

• Architecture Audits: Ask the agent to map out the data flow of a service or explain how a specific design pattern is applied.
• PR Reviews: Use the --genius flag to have the agent analyze a repository before providing feedback on a pull request, ensuring the advice aligns with the existing codebase structure.
• Bug Hunting: Quickly search for implementation details or trace error logs back to the source code definitions without manually opening every file.
• Onboarding: Help new developers understand the codebase by querying the AI for documentation or high-level explanations of core modules.

Example Prompts

1. "Index the repo openclaw/openclaw on the main branch, then tell me how the agent handles tool calls internally."
2. "Search for all instances of payment processing logic in the repository openclaw/skills and list the relevant file paths."
3. "Using the genius analysis mode, explain the authentication flow in the current codebase and identify any security bottlenecks."

Tips & Limitations

Always verify indexing status using the status command before querying, as queries against unindexed or incomplete repos will return outdated or empty results. Remember that the --genius flag consumes more compute tokens but provides significantly higher quality answers for complex structural questions. Currently, the skill supports single-repo operations; if you need to query across multiple repositories simultaneously, you should refer to the raw Greptile API documentation. Keep your tokens secure and scoped strictly to the repositories you need to manage.