Install

pipx install sentience-governor
sentience --help

That’s the install. Two commands. The package registers four CLIs on your $PATH (sentience, sentience-cli, sentience-sync, sentience-claude-code-hook).

Requirements

Python 3.10 or newer
pipx
macOS, Linux, or Windows

Verify

pipx list

Should show package sentience-governor X.Y.Z.

Upgrade

pipx upgrade sentience-governor

Uninstall

pipx uninstall sentience-governor

If you don’t have pipx

brew install pipx          # macOS
# or:
python3 -m pip install --user pipx   # Linux / WSL
pipx ensurepath

Restart your shell after pipx ensurepath.

Library integration (different use case)

If you’re importing sentience_governor as a Python module in your own code (MCP wrapper, LangChain callback, custom agent runtime), install into your project’s virtualenv:

python3 -m venv .venv
source .venv/bin/activate
pip install sentience-governor

In this mode, the CLIs are only on $PATH while the venv is active. Use this path only for library integration. For CLI-only usage, pipx is the right tool.

First-run choices

You want to…	Go to
See what Claude Code is actually doing	Quickstart — Claude Code hook
Wrap your own MCP or LangChain agent	Quickstart — Advanced
Opt into sending aggregated counts to Sentience Cloud	Quickstart — Optional

None of these require an account.

Remove local data (optional)

rm -rf ~/.sentience/

Deletes per-session traces, the Sync state file, and any configuration. Recreated on next run.

Stuck? → Troubleshooting