Steve CLI

A simple CLI tool to run jobs from jobs.yaml with proper environment setup. Perfect for local development and testing of automation kernel jobs.

Installation

Install from local development

cd /home/frank/Projects/7frank/tilt-ts-4/apps/example-hehnke/packages/steve-cli
uv venv
uv pip install -e .

Install from GitHub

uv add steve-cli

uv add git+https://github.com/your-org/tilt-ts-4.git#subdirectory=apps/example-hehnke/packages/steve-cli

Usage

Run a job

steve extract-data
steve transform-data
steve validate-data

This will:

Look for jobs.yaml in the current directory
Find the specified job by name
Set all environment variables from the job's env section
Execute the job's command with the proper environment

List available jobs

steve ls

Shows all jobs in jobs.yaml with their commands, schedules, dependencies, and environment variables.

Get help

steve help
steve --help

Use custom jobs file

steve -f path/to/custom.yaml extract-data
steve ls -f path/to/custom.yaml

Example

Given a jobs.yaml file:

jobs:
  - name: extract-data
    cron: "0 2 * * *"
    command: ["uv", "run", "src/extract.py"]
    env:
      SOURCE_URL: "https://jsonplaceholder.typicode.com/users"
      OUTPUT_PATH: "/data/raw/extracted_data.parquet"

  - name: transform-data
    dependsOn: ["extract-data"]
    command: ["uv", "run", "src/transform.py"]
    env:
      INPUT_PATH: "/data/raw/extracted_data.parquet"
      OUTPUT_PATH: "/data/processed"

Running steve extract-data will:

Set SOURCE_URL=https://jsonplaceholder.typicode.com/users
Set OUTPUT_PATH=/data/raw/extracted_data.parquet
Execute: uv run src/extract.py

Features

✅ Simple: Just steve <job-name> to run any job
✅ Environment: Automatically sets environment variables from jobs.yaml
✅ Discovery: Auto-finds jobs.yaml in current directory
✅ Listing: See all available jobs with steve ls
✅ Flexible: Supports custom jobs file paths
✅ Colorful: Nice colored output for better readability
✅ Error handling: Clear error messages for missing jobs or files

Why Steve?

Named after Steve Jobs - because it helps you run jobs locally! 😄

Requirements

Python 3.8+
click >= 8.0.0
pyyaml >= 6.0

Development

# Install in development mode
uv pip install -e .

# Run tests (when added)
pytest

# Format code
black steve_cli/
isort steve_cli/

use cli

source .venv/bin/activate steve

uv build uv publish

Metadata

Release files for steve-cli 0.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for steve-cli 0.3.7
File	Size	Uploaded
steve_cli-0.3.7.tar.gz	10.9 kB	Jul 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for steve-cli 0.3.7
File	Interpreter	ABI	Platform	Reset
steve_cli-0.3.7-py3-none-any.whl 10.0 kB Jul 7, 2026	Python 3	none	any	Details

Total release size: 20.8 kB

Release files / steve_cli-0.3.7.tar.gz

Download URL	steve_cli-0.3.7.tar.gz
Size	10.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`043b520dddb46254f5dee91ae8a4842205dde1f0c5ac60193face7b2df9ffefc`
BLAKE2b-256 checksum How to use checksums	`f69f54b6af086ac6b72e4ca6820a43be9dd94f775a8f90727586a6243bfae7f7`
Upload date	Jul 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.04","id":"plucky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / steve_cli-0.3.7-py3-none-any.whl

Download URL	steve_cli-0.3.7-py3-none-any.whl
Size	10.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a4d4ceb183e854c6c220bba9a8adaa1ab99ef6fdc8ebe784c54b9fe4dcfc30b8`
BLAKE2b-256 checksum How to use checksums	`37c6afabefba71be94baf2c9060ce63367871063f15533644cd6cd1a027ea119`
Upload date	Jul 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.04","id":"plucky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`