Export tools
Export the specification, generate diagrams, read git history and source documents. This group has 9 tools.
| Tool | Edition | Summary |
|---|---|---|
analyze_image |
Open core | Analyze an image (diagram, screenshot, mockup) using local vision LLM. |
export_srs |
Open core | Export specification to SRS format (IEEE 830). |
generate_diagram |
Open core | Generate a Mermaid diagram for a specification aspect. |
generate_local_diagram |
Open core | Generate a Mermaid diagram using local LLM (Ollama). |
git_branches |
Open core | List git branches. |
git_diff |
Open core | Get current unstaged git diff for a spec element file. |
git_history |
Open core | Get git commit history for a spec element file. |
list_diagram_types |
Open core | List available diagram types for an aspect. |
read_source_document |
Open core | Read RAW input documents from source/ folder (chats, PDFs, text files). |
analyze_image
Analyze an image (diagram, screenshot, mockup) using local vision LLM. Runs fully offline. Requires: ollama pull granite3.2-vision:2b
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
file_path |
string | yes | Path to image file (PNG, JPG, GIF, WebP, BMP) |
export_srs
Export specification to SRS format (IEEE 830). Renders all elements with their relationships and content.
Parameters
This tool takes no parameters.
generate_diagram
Generate a Mermaid diagram for a specification aspect. Returns Mermaid syntax for graph/er/flowchart/class diagrams. Requires project_path.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
aspect |
string | no | Aspect name (default: all aspects) |
diagram_type |
string | no | Diagram type: graph, er, flowchart, class (default: graph) |
node_path |
string | no | Focus on a specific element ID (optional) |
project_path |
string | yes | Path to spec-editor project (directory with methodology.yaml) |
generate_local_diagram
Generate a Mermaid diagram using local LLM (Ollama). Runs fully offline on Apple Silicon. No API key needed. Requires: ollama pull qwen2.5-coder:7b. Requires project_path.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
aspect |
string | no | Aspect name (default: all aspects) |
node_path |
string | no | Focus on a specific element ID (optional) |
project_path |
string | yes | Path to spec-editor project (directory with methodology.yaml) |
git_branches
List git branches. Requires project_path.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_path |
string | yes | Path to spec-editor project (directory with methodology.yaml) |
git_diff
Get current unstaged git diff for a spec element file. Requires project_path.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
element_id |
string | no | Element ID (resolves to file path) |
file_path |
string | no | Path to file |
project_path |
string | yes | Path to spec-editor project (directory with methodology.yaml) |
git_history
Get git commit history for a spec element file. Returns author, date, message for each commit. Requires project_path.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
element_id |
string | no | Element ID (resolves to file path) |
file_path |
string | no | Path to file |
max_count |
integer | no | Max commits (default 50) |
project_path |
string | yes | Path to spec-editor project (directory with methodology.yaml) |
list_diagram_types
List available diagram types for an aspect. Returns which diagram types are supported.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
aspect |
string | no | Aspect name (optional) |
read_source_document
Read RAW input documents from source/ folder (chats, PDFs, text files). These are NOT specification elements — use read_element for those. No args — list files. With filename — file contents.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
filename |
string | no | Filename (optional) |