CLI Getting Started

Get up and running with the Scriptling command-line interface.

Installation

Homebrew (macOS & Linux)

brew install paularlott/tap/scriptling

GitHub Releases

Download pre-built binaries from GitHub Releases:

  • Linux (AMD64, ARM64)
  • macOS (AMD64, ARM64)
  • Windows (AMD64, ARM64)

Build from Source

git clone https://github.com/paularlott/scriptling.git
cd scriptling

# Build CLI for current platform
make build

# Run scripts
./bin/scriptling script.py

Your First Script

Create a file called hello.py:

name = "World"
print(f"Hello, {name}!")

# Use standard libraries
import json
import math

data = json.dumps({"numbers": [1, 2, 3]})
print(data)
print(f"sqrt(16) = {math.sqrt(16)}")

Run it:

scriptling hello.py

Interactive Mode

Launch the REPL to experiment:

scriptling --interactive

Pipe a Script

echo 'print("Hello")' | scriptling

HTTP Server

Run Scriptling as an HTTP server:

scriptling --server :8000 setup.py

MCP Server

Run Scriptling as a Model Context Protocol server for AI integration:

scriptling --server :8000 --mcp-tools ./tools setup.py

Next Steps