.grok/settings.json

@@ -0,0 +1,3 @@
+{
+  "model": "grok-code-fast-1"
+}

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.
 

cmd/query.go

@@ -0,0 +1,53 @@
+package cmd
+
+import (
+	"github.com/fatih/color"
+	"github.com/spf13/cobra"
+	"gmgauthier.com/grokkit/config"
+	"gmgauthier.com/grokkit/internal/grok"
+)
+
+var queryCmd = &cobra.Command{
+	Use:   "query [question]",
+	Short: "One-shot non-interactive query to Grok (programming focused)",
+	Long: `Ask Grok a single technical question and get a concise, actionable answer.
+
+Default mode is factual and brief. Use --wordy for longer, more explanatory answers.`,
+	Args: cobra.MinimumNArgs(1),
+	Run:  runQuery,
+}
+
+func init() {
+	queryCmd.Flags().Bool("wordy", false, "Give a longer, more detailed answer")
+	rootCmd.AddCommand(queryCmd)
+}
+
+func runQuery(cmd *cobra.Command, args []string) {
+	wordy, _ := cmd.Flags().GetBool("wordy")
+	question := args[0]
+
+	// Use fast model by default for quick queries
+	model := config.GetModel("query", "")
+
+	client := grok.NewClient()
+
+	systemPrompt := `You are Grok, a helpful and truthful AI built by xAI.
+Focus on programming, software engineering, and technical questions.
+Be concise, factual, and actionable. Include code snippets when helpful.
+Do not add unnecessary fluff.`
+
+	if wordy {
+		systemPrompt = `You are Grok, a helpful and truthful AI built by xAI.
+Give thorough, detailed, textbook-style answers to technical questions.
+Explain concepts clearly, include examples, and allow light humour where appropriate.
+Be comprehensive but still clear and well-structured.`
+	}
+
+	messages := []map[string]string{
+		{"role": "system", "content": systemPrompt},
+		{"role": "user", "content": question},
+	}
+
+	color.Yellow("Asking Grok...")
+	client.Stream(messages, model)
+}

cmd/root.go

@@ -60,6 +60,7 @@ func init() {
 	rootCmd.AddCommand(docsCmd)
 	rootCmd.AddCommand(testgenCmd)
 	rootCmd.AddCommand(scaffoldCmd)
+	rootCmd.AddCommand(queryCmd)
 
 	// Add model flag to all commands
 	rootCmd.PersistentFlags().StringP("model", "m", "", "Grok model to use (overrides config)")

config/config.go

@@ -36,6 +36,7 @@ func Load() {
 	viper.SetDefault("commands.prdescribe.model", "grok-4")
 	viper.SetDefault("commands.review.model", "grok-4")
 	viper.SetDefault("commands.docs.model", "grok-4")
+	viper.SetDefault("commands.query.model", "grok-4-1-fast-non-reasoning")
 
 	// Config file is optional, so we ignore read errors
 	_ = viper.ReadInConfig()