52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
|
# Grokkit User's Guide
|
||
|
|
|
||
|
|
Welcome to the full user documentation for **Grokkit** — a fast, native Go CLI for Grok that supercharges your coding workflow.
|
||
|
|
|
||
|
|
## Quick Navigation
|
||
|
|
|
||
|
|
### 🛡️ Safety & Change Management
|
||
|
|
- **[Safety & Change Management](safety.md)** — Learn how Grokkit integrates with Git to keep your codebase stable and safe.
|
||
|
|
|
||
|
|
### 🔄 Workflows
|
||
|
|
- **[Grokkit Workflows](workflows.md)** — Learn how to integrate Grokkit into your development cycle effectively.
|
||
|
|
|
||
|
|
### Core Commands
|
||
|
|
- **[👨🍳 Recipe](recipe.md)** — The star of the show. Run powerful, transactional, multi-step LLM workflows defined in simple markdown files.
|
||
|
|
- **[🤖 Agent](agent.md)** — Multi-file agent for complex refactorings and project-wide changes.
|
||
|
|
- **[🏗️ Scaffold](scaffold.md)** — Safely generate new files with Grok preview + confirmation.
|
||
|
|
- **[🧪 Testgen](testgen.md)** — Generate high-quality unit tests for Go, Python, C/C++, etc.
|
||
|
|
- **[✏️ Edit](edit.md)** — In-place file editing with Grok (safe preview mode).
|
||
|
|
|
||
|
|
### Git Workflow Commands
|
||
|
|
- **[✅ Commit](commit.md)** — AI-powered conventional commit messages with direct git commit.
|
||
|
|
- **[📝 Commit-Msg](commit-msg.md)** — Generate AI-suggested conventional commit messages.
|
||
|
|
- **[🗒️ Changelog](changelog.md)** — Generate CHANGELOG.md from git history.
|
||
|
|
- **[📋 PR-Describe](pr-describe.md)** — Generate full PR descriptions.
|
||
|
|
- **[📜 History](history.md)** — Summarize recent git history.
|
||
|
|
|
||
|
|
### Other Useful Commands
|
||
|
|
- **[💬 Chat](chat.md)** — Full interactive chat with history and streaming
|
||
|
|
- **[🤖 Query](query.md)** — One-shot programming-focused queries
|
||
|
|
- **[🔍 Review](review.md)** — AI code review of the current repo/directory
|
||
|
|
- **[🔧 Lint](lint.md)** — Lint + AI-suggested fixes
|
||
|
|
- **[📖 Docs](docs.md)** — Generate documentation comments
|
||
|
|
- **[Completion](completion.md)** — Generate shell completion scripts
|
||
|
|
- **[🏷️ Version](version.md)** — Print version information
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Getting Started
|
||
|
|
|
||
|
|
See the [main README](../README.md) for installation and basic usage.
|
||
|
|
|
||
|
|
See the [Configuration Guide](../developer-guide/CONFIGURATION.md) for detailed information on how to configure Grokkit via environment variables and config files.
|
||
|
|
|
||
|
|
Want to dive deep? Start with the **[Recipe Guide](recipe.md)** — it's the most powerful and unique feature of Grokkit.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Contributing to the Docs
|
||
|
|
|
||
|
|
Found something missing or unclear? Feel free to open a PR or issue on the repo.
|
||
|
|
|
||
|
|
Happy hacking!
|