Initial commit

skills/local-brain/references/CLI_REFERENCE.md

@@ -0,0 +1,57 @@
+# Local Brain CLI Reference
+
+## Installation
+
+```bash
+# Via cargo-binstall (recommended)
+cargo binstall local-brain
+
+# Or from source
+cargo install --git https://github.com/IsmaelMartinez/local-brain
+```
+
+## Command Line Flags
+
+### Input Modes
+
+- `--files <FILES>` - Comma-separated list of files to review
+- `--git-diff` - Review all changed files in git working directory
+- `--dir <DIR> --pattern <PATTERN>` - Review files in directory matching glob pattern
+
+### Optional Flags
+
+- `--task <TASK>` - Task-based model selection: quick-review, thorough-review, security, documentation, architecture, refactoring
+- `--model <MODEL>` - Override default model (e.g., qwen2.5-coder:3b)
+- `--kind <KIND>` - Document type: code, design-doc, ticket, other
+- `--review-focus <FOCUS>` - Review focus: refactoring, readability, performance, risk, general
+- `--dry-run` - Test without calling Ollama (validate inputs only)
+
+## Environment Variables
+
+- `OLLAMA_HOST` - Ollama server URL (default: `http://localhost:11434`)
+- `MODEL_NAME` - Default model to use
+
+## Output Format
+
+Structured Markdown with sections:
+- **Issues Found** - Problems requiring attention (with line numbers)
+- **Simplifications** - Opportunities to reduce complexity
+- **Consider Later** - Non-critical improvements
+- **Other Observations** - General notes
+
+## Troubleshooting
+
+### Ollama Not Running
+```
+Error: Failed to send request to Ollama
+```
+Start Ollama: `ollama serve`
+
+### Model Not Found
+```
+Error: model 'xyz' not found
+```
+Pull a model: `ollama pull qwen2.5-coder:3b`
+
+### No Output
+Ensure Ollama has enough RAM for the model. Check `ollama ps` for running models.

skills/local-brain/references/HOOKS.md

@@ -0,0 +1,97 @@
+# Local AI Hooks
+
+Lightweight shell functions for quick AI operations. Defined in `~/.zshrc`.
+
+## Available Hooks
+
+### ai - Concise Q&A
+
+Quick, concise question answering using local Ollama model.
+
+**Usage:**
+```bash
+ai "your question here"
+```
+
+**Example:**
+```bash
+ai "what does the grep -r flag do?"
+ai "what is a closure in rust?"
+```
+
+**Output:** Concise, direct answers without lengthy explanations
+
+**When to use:**
+- Quick factual questions
+- Need brief, to-the-point answers
+- Want to minimize token usage
+
+### ai-cmd - Command Generation
+
+Generate shell commands from natural language task descriptions.
+
+**Usage:**
+```bash
+ai-cmd "what you want to do"
+```
+
+**Example:**
+```bash
+ai-cmd "find all rust files modified in the last week"
+ai-cmd "count lines in all python files"
+```
+
+**Output:** Shell commands only, no commentary
+
+**When to use:**
+- Need shell command for a specific task
+- Don't remember exact syntax
+- Want safe command suggestions
+
+### ai-explain - Detailed Explanation
+
+Explain the last command, or provide detailed explanation of a given string.
+
+**Usage:**
+```bash
+# Explain last command and recent output
+ai-explain
+
+# Explain a specific string (code, concept, etc)
+ai-explain "string to explain"
+```
+
+**Example:**
+```bash
+# Explain last command
+ai-explain
+
+# Explain a code pattern
+ai-explain "async/await in Rust"
+
+# Explain an error message
+ai-explain "connection refused on port 8080"
+```
+
+**Output:** Detailed technical explanation with context, implications, and solutions
+
+**When to use:**
+- Understand what last command did or what went wrong
+- Need detailed explanation of a concept or error
+- Want suggestions for fixing/improving
+
+## Default Model
+
+All hooks use: `deepseek-coder-v2-8k` (configurable via `OLLAMA_MODEL` env var)
+
+## Decision Matrix: Hooks vs local-brain Binary
+
+| Scenario | Tool | Reason |
+|----------|------|--------|
+| Quick question | `ai` hook | Fastest, no file reading |
+| Generate command | `ai-cmd` hook | Direct shell output |
+| Explain last command | `ai-explain` hook | Auto-captures context |
+| Review single file | `local-brain` binary | Structured output |
+| Review multiple files | `local-brain` binary | Handles multiple files |
+| Review directory | `local-brain` binary | Directory traversal |
+| Git diff review | `local-brain` binary | Git integration |