Metadata-Version: 2.4
Name: tokki
Version: 0.0.4
Summary: Opt-in local agent wrapper CLI for Tokki.
Author: Jean-Pierre Morard
Maintainer: Jean-Pierre Morard
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://github.com/jpmorard/tokki-public
Project-URL: Repository, https://github.com/jpmorard/tokki-public
Project-URL: Issues, https://github.com/jpmorard/tokki-public/issues
Keywords: tokki
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Tokki

Tokki provides an opt-in local wrapper for supported AI coding agents.

The PyPI package does not silently replace existing agent commands during
installation. Install it, inspect the environment, then explicitly enable the
Codex wrapper when wanted:

```sh
python -m pip install tokki
tokki doctor
tokki codex install-wrapper
```

After `tokki codex install-wrapper`, future `codex` launches go through a
Tokki PATH shim when the reported bin directory is before the original Codex
directory in `PATH`.

Useful commands:

```sh
tokki codex status
tokki codex uninstall-wrapper
tokki doctor --strict
```

Wrapped Codex sessions expose `TOKKI_ACTIVE=1`, `TOKKI_SESSION_ID`, and a
runtime metadata file path in `TOKKI_RUNTIME_CONFIG`.

Tokki implementation source remains proprietary. Public project information is
available at https://github.com/jpmorard/tokki-public.
