check-gol 0.1.0

Check — preflight validation for shell commands. Know if a command will work before running it.

check-gol

Check — preflight validation for shell commands. Know if a command will work before running it.

$0.0068 AUD per check. Zero dependencies.

Install

pip install check-gol

Usage

from check_gol import Check

check = Check()  # reads GOL_CLIENT_ID from env

result = check.command("curl https://api.example.com/health")
print(result.runnable)  # True
print(result.verdict)   # "runnable"

Guard pattern

from check_gol import Check, InvalidCommand

check = Check()

try:
    check.guard("curl https://dead.endpoint.example")
except InvalidCommand:
    print("Command would fail — skipping")

OpenAI function calling

from openai import OpenAI
from check_gol import Check

client = OpenAI()
check = Check()

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Check if this API is live: https://api.example.com"}],
    tools=[check.openai_tool()],
)

for tool_call in response.choices[0].message.tool_calls or []:
    if tool_call.function.name == "check":
        output = check.handle_openai_call(tool_call.function.arguments)

LangChain

pip install check-gol[langchain]

from check_gol.langchain import CheckTool

tools = [CheckTool()]

CrewAI

pip install check-gol[crewai]

from check_gol.crewai import CheckTool

agent = Agent(tools=[CheckTool()])

Claude MCP

Use the check-mcp npm package instead.

Environment

Set GOL_CLIENT_ID or pass it directly:

check = Check(client_id="gol_xxxx")

Get your key at golproductions.com/check.html