Metadata-Version: 2.4
Name: check-gol
Version: 0.1.0
Summary: Check — preflight validation for shell commands. Know if a command will work before running it.
Project-URL: Homepage, https://www.golproductions.com/check.html
Project-URL: Repository, https://github.com/ADA-ADAMA/check-python
Author: GOL Productions
License-Expression: LicenseRef-Proprietary
License-File: LICENSE
Keywords: agent,ai,check,command,llm,preflight,validation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Provides-Extra: crewai
Requires-Dist: crewai>=0.41; extra == 'crewai'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2; extra == 'langchain'
Description-Content-Type: text/markdown

# 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

```python
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

```python
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

```python
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]
```

```python
from check_gol.langchain import CheckTool

tools = [CheckTool()]
```

### CrewAI

```
pip install check-gol[crewai]
```

```python
from check_gol.crewai import CheckTool

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

### Claude MCP

Use the [check-mcp](https://www.npmjs.com/package/check-mcp) npm package instead.

## Environment

Set `GOL_CLIENT_ID` or pass it directly:

```python
check = Check(client_id="gol_xxxx")
```

Get your key at [golproductions.com/check.html](https://www.golproductions.com/check.html)
