iknowhy 0.1.0

Causal event capture for AI agents

iknowhy

Causal event capture for AI agents. Track every decision, tool call, and outcome — and trace any result back to its root cause.

Install

pip install iknowhy

Quickstart

from iknowhy import CausewayClient

c = CausewayClient(api_key='cwy_your_key')

# Log a causal chain
req  = c.log('user_request', payload={'task': 'search docs'}, session_id='s1')
call = c.log('tool_call',    payload={'tool': 'web_search'}, cause_ids=[req], session_id='s1')
res  = c.log('tool_result',  payload={'results': 5},         cause_ids=[call], session_id='s1')

# Trace back from any event
chain = c.chain(res)
for e in chain:
    print(e['name'], '->', e['payload'])

API key

Get a free key at https://iknowhy.ai