thulp-cli

Command-line interface for the Thulp execution context engineering platform.

Overview

This crate provides a full-featured CLI for interacting with Thulp tools, MCP servers, and OpenAPI adapters. It supports multiple output formats (text, JSON) and shell completion generation.

Features

• Tool Management: List, show, and validate tool definitions
• MCP Integration: Connect to MCP servers via STDIO or HTTP
• OpenAPI Conversion: Convert OpenAPI specs to tool definitions
• Multiple Output Formats: Human-readable text or JSON output
• Shell Completions: Generate completions for Bash, Zsh, Fish, PowerShell, and Elvish
• Demo Mode: Interactive demonstration of core functionality

Installation

Install from crates.io:

cargo install thulp-cli

Or build from source:

cargo build --release -p thulp-cli

With MCP support:

cargo install thulp-cli --features mcp

Usage

List Tools

# Human-readable output
thulp tools list

# JSON output
thulp tools list --output json

Show Tool Details

thulp tools show read_file
thulp tools show read_file --output json

Validate Tool Arguments

# Validate with JSON arguments (positional argument)
thulp tools validate read_file '{"path": "/etc/hosts"}'

# JSON output for scripting
thulp tools validate read_file '{}' --output json

MCP Server Connection (requires mcp feature)

# Connect via HTTP
thulp mcp connect-http myserver http://localhost:8080

# Connect via STDIO
thulp mcp connect-stdio myserver /path/to/mcp-server -- --verbose

# List tools from MCP server
thulp mcp list

# Call MCP tool
thulp mcp call search '{"query": "test"}'

# Check connection status
thulp mcp status

OpenAPI Conversion

# Convert OpenAPI spec to tool definitions
thulp convert openapi spec.yaml
thulp convert openapi spec.json --output tools.yaml

# Show conversion examples
thulp convert examples

Generate Shell Completions

# Bash
thulp completions bash > ~/.local/share/bash-completion/completions/thulp

# Zsh
thulp completions zsh > ~/.zfunc/_thulp

# Fish
thulp completions fish > ~/.config/fish/completions/thulp.fish

# PowerShell
thulp completions powershell >> $PROFILE

# Output to directory
thulp completions bash --dir ~/.local/share/bash-completion/completions

Run Demo

# Interactive demo
thulp demo

# JSON output for testing
thulp demo --output json

Validate Configuration

thulp validate config.yaml

Output Formats

The CLI supports three output formats:

Commands

Feature Flags

Testing

cargo test -p thulp-cli

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.