Example Tools
CmdForge comes with 28 pre-built tools. This document shows their configurations and usage.
+Quick Install
+# Install all example tools (from the CmdForge directory)
python examples/install.py
cmdforge refresh
# Or install from anywhere
curl -sSL https://gitea.brrd.tech/rob/cmdforge/raw/branch/main/examples/install.py | python3
Text Processing Tools
+summarize
+Condense long documents to key points.
+name: summarize
description: Condense long documents to key points
arguments:
- flag: --length
variable: length
default: "3-5 bullet points"
steps:
- type: prompt
prompt: |
Summarize the following text into \{length\}. Be concise and capture the key points:
\{input\}
provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+cat article.txt | summarize
cat book.txt | summarize --length "10 bullet points"
+
translate
+Translate text to any language.
+name: translate
description: Translate text to any language
arguments:
- flag: --lang
variable: lang
default: Spanish
steps:
- type: prompt
prompt: |
Translate the following text to \{lang\}. Only output the translation, nothing else:
\{input\}
provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+echo "Hello, world!" | translate --lang French
cat readme.md | translate --lang Japanese
+
fix-grammar
+Fix grammar and spelling errors.
+name: fix-grammar
description: Fix grammar and spelling errors
arguments: []
steps:
- type: prompt
prompt: |
Fix all grammar, spelling, and punctuation errors in the following text. Only output the corrected text, no explanations:
\{input\}
provider: opencode-deepseek
output_var: response
output: "\{response\}"
Usage:
+echo "teh cat sat on teh mat" | fix-grammar
cat draft.txt | fix-grammar > fixed.txt
+
simplify
+Rewrite text for easier understanding.
+name: simplify
description: Rewrite text for easier understanding
arguments:
- flag: --level
variable: level
default: "5th grade reading level"
steps:
- type: prompt
prompt: |
Rewrite the following text for a \{level\}. Keep the meaning but use simpler words and shorter sentences:
\{input\}
provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+cat legal_document.txt | simplify
cat technical.md | simplify --level "non-technical reader"
+
tone-shift
+Change the tone of text.
+name: tone-shift
description: Change the tone of text
arguments:
- flag: --tone
variable: tone
default: professional
steps:
- type: prompt
prompt: |
Rewrite the following text in a \{tone\} tone. Keep the core message but adjust the style:
\{input\}
provider: opencode-deepseek
output_var: response
output: "\{response\}"
Usage:
+cat angry_email.txt | tone-shift --tone "calm and professional"
cat casual_note.txt | tone-shift --tone formal
+
eli5
+Explain like I'm 5.
+name: eli5
description: Explain like I'm 5
arguments: []
steps:
- type: prompt
prompt: |
Explain this like I'm 5 years old. Use simple words and fun analogies:
\{input\}
provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+echo "What is quantum computing?" | eli5
cat whitepaper.txt | eli5
+
tldr
+One-line summary.
+name: tldr
description: One-line summary
arguments: []
steps:
- type: prompt
prompt: |
Give a one-line TL;DR summary of this text:
\{input\}
provider: opencode-grok
output_var: response
output: "\{response\}"
Usage:
+cat long_article.txt | tldr
curl -s https://example.com | tldr
+
expand
+Expand bullet points to paragraphs.
+name: expand
description: Expand bullet points to paragraphs
arguments: []
steps:
- type: prompt
prompt: |
Expand these bullet points into well-written paragraphs:
\{input\}
provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+cat notes.txt | expand
echo "- Fast\n- Reliable\n- Easy to use" | expand
+
Developer Tools
+explain-error
+Explain error messages and stack traces.
+name: explain-error
description: Explain error messages and stack traces
arguments: []
steps:
- type: prompt
prompt: |
Explain this error/stack trace in plain English. What went wrong and how to fix it:
\{input\}
provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+cat error.log | explain-error
python script.py 2>&1 | explain-error
+
explain-code
+Explain what code does.
+name: explain-code
description: Explain what code does
arguments:
- flag: --detail
variable: detail
default: moderate
steps:
- type: prompt
prompt: |
Explain what this code does at a \{detail\} level of detail:
{input}
+provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+cat script.py | explain-code
cat complex.js | explain-code --detail "very detailed"
+
review-code
+Quick code review with suggestions.
+name: review-code
description: Quick code review with suggestions
arguments:
- flag: --focus
variable: focus
default: "bugs, security, and improvements"
steps:
- type: prompt
prompt: |
Review this code focusing on \{focus\}. Be concise and actionable:
{input}
+provider: claude-sonnet
output_var: response
output: "\{response\}"
Usage:
+cat pull_request.diff | review-code
cat auth.py | review-code --focus "security vulnerabilities"
+
gen-tests
+Generate unit tests for code.
+name: gen-tests
description: Generate unit tests for code
arguments:
- flag: --framework
variable: framework
default: pytest
steps:
- type: prompt
prompt: |
Generate comprehensive unit tests for this code using \{framework\}. Include edge cases:
{input}
+provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+cat utils.py | gen-tests
cat api.js | gen-tests --framework jest
+
docstring
+Add docstrings to functions/classes.
+name: docstring
description: Add docstrings to functions/classes
arguments:
- flag: --style
variable: style
default: Google style
steps:
- type: prompt
prompt: |
Add \{style\} docstrings to all functions and classes in this code. Output the complete code with docstrings:
{input}
+provider: opencode-deepseek
output_var: response
output: "\{response\}"
Usage:
+cat module.py | docstring
cat functions.py | docstring --style "NumPy style"
+
commit-msg
+Generate commit message from diff.
+name: commit-msg
description: Generate commit message from diff
arguments:
- flag: --style
variable: style
default: conventional commits
steps:
- type: prompt
prompt: |
Generate a concise \{style\} commit message for this diff. Just the message, no explanation:
\{input\}
provider: opencode-pickle
output_var: response
output: "\{response\}"
Usage:
+git diff --staged | commit-msg
git diff HEAD~1 | commit-msg --style "simple"
+
Data Tools
+json-extract
+Extract structured data as validated JSON.
+name: json-extract
description: Extract structured data as validated JSON
arguments:
- flag: --fields
variable: fields
default: any relevant fields
steps:
- type: prompt
prompt: |
Extract \{fields\} from this text as a JSON object. Output ONLY valid JSON, no markdown, no explanation:
\{input\}
provider: opencode-deepseek
output_var: raw_json
- type: code
code: |
import json
import re
text = raw_json.strip()
text = re.sub(r'^```json?\s*', '', text)
text = re.sub(r'\s*```$', '', text)
try:
parsed = json.loads(text)
validated = json.dumps(parsed, indent=2)
except json.JSONDecodeError as e:
validated = f"ERROR: Invalid JSON - {e}\nRaw output: {text[:500]}"
output_var: validated
output: "\{validated\}"
Usage:
+echo "Price $49.99, SKU ABC-123" | json-extract --fields "price, sku"
cat invoice.txt | json-extract --fields "total, date, items"
+
sql-from-text
+Generate SQL from natural language.
+name: sql-from-text
description: Generate SQL from natural language
arguments:
- flag: --dialect
variable: dialect
default: PostgreSQL
steps:
- type: prompt
prompt: |
Generate a \{dialect\} SQL query for this request. Output only the SQL, no explanation:
\{input\}
provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+echo "get all users who signed up last month" | sql-from-text
echo "count orders by status" | sql-from-text --dialect MySQL
+
Advanced Multi-Step Tools
+log-errors
+Extract and explain errors from large log files.
+name: log-errors
description: Extract and explain errors from large log files
arguments: []
steps:
- type: code
code: |
import re
lines = input.split('\n')
result = []
for i, line in enumerate(lines):
if re.search(r'\b(ERROR|CRITICAL|FATAL|Exception|Traceback)\b', line, re.I):
result.extend(lines[i:i+5])
extracted = '\n'.join(result[:200])
output_var: extracted
- type: prompt
prompt: |
Analyze these error log entries. Group by error type, explain likely causes, and suggest fixes:
\{extracted\}
provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+cat huge_app.log | log-errors
zcat archived.log.gz | log-errors
+
diff-focus
+Review only the added/changed code in a diff.
+name: diff-focus
description: Review only the added/changed code in a diff
arguments: []
steps:
- type: code
code: |
lines = input.split('\n')
result = []
for i, line in enumerate(lines):
if line.startswith('@@') or line.startswith('+++') or line.startswith('---'):
result.append(line)
elif line.startswith('+') and not line.startswith('+++'):
result.append(line)
extracted = '\n'.join(result)
output_var: extracted
- type: prompt
prompt: |
Review these added lines of code. Focus on bugs, security issues, and improvements:
\{extracted\}
provider: claude-haiku
output_var: response
output: "\{response\}"
Usage:
+git diff | diff-focus
git diff HEAD~5 | diff-focus
+
Pipeline Recipes
+CmdForge tools chain together like Unix commands:
+Development Workflows
+# Quick PR review: extract changes, review, summarize
git diff main | diff-focus | review-code --focus "bugs and security" | tldr
# Explain and fix an error in one pipeline
python script.py 2>&1 | explain-error | tee error_analysis.txt
# Generate tests for changed files only
git diff --name-only | grep '\.py$' | xargs cat | gen-tests > new_tests.py
# Create release notes from commits
git log v1.0..v1.1 --oneline | changelog | translate --lang French > RELEASE_FR.md
Data Processing
+# Extract, transform, analyze
curl -s api.example.com/data | json-extract --fields "users, revenue" | json2csv | csv-insights
# Process multiple files
for f in reports/*.txt; do
cat "$f" | json-extract --fields "total, date"
done | json2csv > summary.csv
Text Processing Pipelines
+# Translate technical docs for international team
cat API.md | simplify --level "non-technical" | translate --lang Spanish > API_ES.md
# Process customer feedback
cat feedback.txt | summarize --length "10 points" | tone-shift --tone analytical
Shell Functions
+Add to ~/.bashrc for common workflows:
# Review recent changes
review-recent() {
git diff HEAD~"${1:-1}" | diff-focus | review-code | tldr
}
# Quick translate with summary
translate-summary() {
cat "$1" | summarize | translate --lang "${2:-Spanish}"
}
# Generate commit message and commit
auto-commit() {
msg=$(git diff --staged | commit-msg)
echo "Commit message: $msg"
read -p "Commit? [y/N] " confirm
[[ $confirm == [yY] ]] && git commit -m "$msg"
}