grokkit/docs/user-guide/index.md
Greg Gauthier 65f67ff7b1
All checks were successful
CI / Test (push) Successful in 34s
CI / Lint (push) Successful in 25s
CI / Build (push) Successful in 23s
feat(workon): implement automated todo workflow with AI plans and branch management
- Add workon command to automate starting/completing todos/fixes
- Generate AI-powered work plans and handle git branching
- Update README and user docs with workon guide
- Move workon todo item to completed
2026-03-31 22:23:35 +01:00

2.7 KiB

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

🔄 Workflows

  • Grokkit Workflows — Learn how to integrate Grokkit into your development cycle effectively.

Core Commands

  • 👨‍🍳 Recipe — The star of the show. Run powerful, transactional, multi-step LLM workflows defined in simple markdown files.
  • 🤖 Agent — Multi-file agent for complex refactorings and project-wide changes.
  • 🏗️ Scaffold — Safely generate new files with Grok preview + confirmation.
  • 🧪 Testgen — Generate high-quality unit tests for Go, Python, C/C++, etc.
  • ✏️ Edit — In-place file editing with Grok (safe preview mode).

Git Workflow Commands

Productivity Commands

  • 🔨 Workon — Automate starting and completing todo items and fixes with AI work plans.

Other Useful Commands

  • 💬 Chat — Full interactive chat with history and streaming
  • 🤖 Query — One-shot programming-focused queries
  • 🔍 Review — AI code review of the current repo/directory
  • 🔧 Lint — Lint + AI-suggested fixes
  • 🔎 Analyze — Deep educational analysis of any codebase with custom language prompts.
  • 📖 Docs — Generate documentation comments
  • Completion — Generate shell completion scripts
  • 🏷️ Version — Print version information

Getting Started

See the main README for installation and basic usage.

See the Configuration Guide for detailed information on how to configure Grokkit via environment variables and config files.

Want to dive deep? Start with the Recipe Guide — 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!