Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add rules/superagent-ai/grok-cli/project-overviewgit clone --depth 1 https://github.com/superagent-ai/grok-cliWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00753 | $0.00753 |
| Opus 5 | $0.00377 | $0.00377 |
| Sonnet 5 | $0.00151 | $0.00151 |
| Haiku 4.5 | $0.00075 | $0.00075 |
Grade A, and why
project-overview scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 66 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Grok CLI — Project Overview
Grok CLI (@vibe-kit/grok-cli) is an open-source AI coding agent powered by Grok that brings AI assistance directly into the terminal.
Tech Stack
- Language: TypeScript (ES2022, ESNext modules)
- Runtime: Bun (primary)
- UI Framework: React with OpenTUI for terminal rendering
- Build:
tsc(TypeScript compiler) - Package Manager: Bun
- API Client: OpenAI SDK (for OpenAI-compatible xAI API)
- Tools: Bash-only (all file operations via shell commands)
- Search: X Search API + Web Search via xAI Responses API
Architecture
src/
├── index.ts # CLI entry point (Commander.js + OpenTUI)
├── agent/
│ └── agent.ts # Agent — orchestrates client, bash tool, search
├── grok/
│ ├── client.ts # Grok API client (Chat Completions + Responses API)
│ ├── models.ts # Model definitions and metadata
│ └── tools.ts # Tool schemas (bash, search_web, search_x)
├── tools/
│ └── bash.ts # Bash command execution
├── ui/
│ └── app.tsx # OpenTUI React terminal UI
├── utils/
│ ├── settings.ts # User and project settings
│ ├── git-root.ts # Resolve git repository root for AGENTS.md discovery
│ └── instructions.ts # AGENTS.md (ecosystem) custom instructions
└── types/
└── index.ts # Shared TypeScript types
Key Patterns
- Agent loop:
Agent.processMessage()is an async generator that yieldsStreamChunkobjects — the LLM responds, tools execute, results feed back until no more tool calls remain. - Bash-only tools: The agent uses bash for everything (file editing, searching, git, builds, etc.).
- X Search & Web Search: Integrated via the xAI Responses API for real-time information.
- Settings hierarchy: Environment variables → User-level (
~/.grok/user-settings.json) → Project-level (.grok/settings.json). - Custom instructions:
~/.grok/AGENTS.md, thenAGENTS.override.md/AGENTS.mdper directory from git root through the workspace cwd (Codex-style merge). - ESM only: The project uses
"type": "module"— all imports use.jsextensions for compiled output.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 66 lines · 753 tokens per session scan A 523d3251e067
project-overview is a cursor rule published in the GitHub repository superagent-ai/grok-cli (3,441 stars, last pushed 1mo ago), licensed MIT. It adds 753 tokens to every session, about $0.0038 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other cursor rules, from other repositories
grok-mcp
Grok MCP orchestrator — cheap worker, unpin, typed sessionnext cards.
cursorrules
Cursor rule "cursorrules" from florian101010/awesome-agentic-AI-coding-template, covering key rules, documentation hygiene, after every change, available workflows and key files.
use-bun-instead-of-node-vite-npm-pnpm
../../CLAUDE.md.
api-property-optionality-hygiene
Fix ApiProperty/ApiPropertyOptional optionality mismatches in DTO files; use for scheduled batch fixes or DTO edits.
java-springboot-jpa-cursorrules-prompt-file
description: "Cursor rules for Java development with Springboot and JPA integration." globs: / alwaysApply: false.
conservative-file-creation
Check for existing files before creating. Be conservative about new files and code.