Metadata-Version: 2.4
Name: kmbit-client
Version: 0.1.0
Summary: KmBiT Spatial Awareness Client — Track AI agent locations in codebases
Project-URL: Homepage, https://humotica.com
Project-URL: Repository, https://github.com/jaspertvdm/kmbit-kernel
Author-email: Jasper van de Meent <info@humotica.com>, Root AI <root_ai@humotica.nl>
License: MIT
Keywords: agent-tracking,ai,collision-detection,humotica,kmbit,multi-agent,spatial-awareness
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: requests>=2.28
Description-Content-Type: text/markdown

# kmbit-client

Spatial Awareness Client for AI Agents.

> Track where AI agents are working in the codebase, detect collisions, and coordinate multi-agent workflows.

## Install

```bash
pip install kmbit-client
```

## Usage

```python
from kmbit_client import KmBiT

kmbit = KmBiT(agent="my-agent")
kmbit.here("/path/to/file.py", "implementing feature X")

# Context manager
with kmbit.at("/path/to/file.py", "reviewing code"):
    pass

# Query
kmbit.where_am_i()
kmbit.who_is_here()
kmbit.hot_zones()
```

## Part of HumoticaOS

```
kmbit-kernel    Route queries to agents (AI Filesystem)
kmbit-client    Track agent locations (Spatial Awareness)  <- you are here
```

## License

MIT — [Humotica](https://humotica.com)
