From 587be3a0463febd80a8262ea412b7cdf57a4f27d Mon Sep 17 00:00:00 2001
From: Gregory Gauthier <gregory.gauthier@perspectum.com>
Date: Wed, 4 Mar 2026 15:50:46 +0000
Subject: [PATCH] docs: add grokkit query command documentation to README

- Added entry to commands list
- Created new section with usage examples and features
---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 23998b1..2ee8fb0 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ grokkit version
 
 - [Commands](#commands)
   - [chat](#-grokkit-chat)
+  - [query](#-grokkit-query)
   - [edit](#-grokkit-edit-file-instruction)
   - [commit / commitmsg](#-grokkit-commitmsg)
   - [review](#-grokkit-review)
@@ -72,6 +73,25 @@ grokkit chat --debug            # Enable debug logging
 - History is saved automatically between sessions
 - Use `--debug` to see API request timing
 
+### 🤖 `grokkit query`
+
+One-shot technical question answering. Perfect for quick programming or engineering questions.
+
+```bash
+# Basic usage
+grokkit query "How do I sort a slice of structs by a field in Go?"
+
+# Longer, more detailed answer
+grokkit query --wordy "Explain how Go's context package works with cancellation"
+```
+Features:
+
+Default mode is concise, factual, and actionable
+--wordy flag gives longer, more explanatory answers
+Uses the fast non-reasoning model by default for speed
+No persistent history or interactive chat UI
+
+
 ### ✏️ `grokkit edit FILE "instruction"`
 AI-powered file editing with preview.