llm-box Setup

Prerequisites

• Go 1.21+ (for building from source) OR a pre-built binary

Installation

Option 1: Install Script (Linux/macOS)

curl -sL https://raw.githubusercontent.com/alib8b8/llm-box/main/install.sh -o install.sh
bash install.sh

Option 2: Go Install

go install github.com/alib8b8/llm-box/cmd/llm-box@latest

Option 3: Download from Releases

Download the binary for your platform:

https://github.com/alib8b8/llm-box/releases

Verify Installation

llm-box list

MCP Server

The plugin includes a pre-configured MCP server in .mcp.json:

{
  "mcpServers": {
    "llm-box": {
      "type": "stdio",
      "command": "llm-box",
      "args": ["--mcp-server"]
    }
  }
}

Claude Code will automatically start the MCP server when the plugin is activated.

Configuration

Create ~/.llm-box/config.yaml:

safe_mode: false
default_model: "ollama://llama3"
api_keys:
  openai: "your-api-key"
  deepseek: "your-api-key"

Troubleshooting

1. Check if llm-box is in PATH: which llm-box
2. Verify version: llm-box --version
3. Test MCP server: llm-box --mcp-server

llm-box Workflow Skill

When to Use

Use this skill when the user wants to:

• Automate multi-step terminal tasks — fetching data, processing it, saving results
• Create reusable pipelines — workflows that can be run repeatedly
• Chain commands — where output of one step feeds into the next
• Batch process data — transform, filter, combine multiple data sources
• Integrate LLMs into automation — use Ollama, DeepSeek, or OpenAI-compatible models
• Replace fragile bash scripts — with structured, auditable YAML workflows

How llm-box Works

Plain English description → YAML workflow → Execute with progress

llm-box generates a YAML workflow file from a natural language description.

The workflow is deterministic and reproducible — same workflow always produces

the same result. Users can edit the YAML by hand if they want to tweak things.

Quick Reference

CLI Commands

# Generate a workflow from plain English
llm-box create "<description>"

# Run a workflow file
llm-box run <workflow.yaml>

# List all available nodes
llm-box list

# Validate a workflow file without running
llm-box validate <workflow.yaml>

# Run in safe mode (disables execute node)
llm-box --safe-mode run <workflow.yaml>

# Dry run (show steps without executing)
llm-box --dry-run run <workflow.yaml>

Available Nodes

Utility Nodes:

LLM Nodes: