Metadata-Version: 2.4
Name: truealter
Version: 0.1.0
Summary: Thin PyPI shim that invokes the ALTER CLI (installed separately via npm).
Project-URL: Homepage, https://truealter.com
Project-URL: Documentation, https://truealter.com/docs
Project-URL: Repository, https://github.com/true-alter/alter-runtime
Project-URL: Bug Tracker, https://github.com/true-alter/alter-runtime/issues
Project-URL: Canonical CLI (npm), https://www.npmjs.com/package/@truealter/cli
Author: Blake Morrison
Author-email: ALTER Meridian Pty Ltd <hello@truealter.com>
License: Apache-2.0
Keywords: alter,cli,identity,mcp,model-context-protocol,truealter
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software 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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Shells
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# truealter

> **Python console-script shim for the [ALTER](https://truealter.com) CLI.**
> The canonical ALTER CLI ships from `@truealter/cli` on npm. This package
> exists as a fourth install channel for pip-centric users.

## Install

```bash
pip install truealter
```

After installation, `truealter` is on your PATH. The first time you run it, it
execs the `alter` binary from npm — so you need that installed too:

```bash
npm install -g @truealter/cli
```

With both installed, `truealter <args>` is equivalent to `alter <args>`.

## Why a shim?

The CLI itself is a Node.js project (see `@truealter/cli` on npm). We publish
a thin Python shim so that:

- `pip install` users on systems without a global npm setup get a discoverable
  entry point and helpful install guidance.
- CI images that only have Python tooling can install a placeholder that
  prints a clear, actionable error rather than "command not found".
- The `truealter` PyPI name is reserved for this ecosystem and cannot be
  squatted later.

If the canonical node-side CLI isn't on your PATH, `truealter` prints install
instructions and exits with status `127`. It never silently runs a half-working
re-implementation of the real CLI.

## Related packages

- `@truealter/cli` on npm — the canonical CLI
- `alter-runtime` on PyPI — the ALTER identity daemon (separate, runs
  alongside; this shim is a sibling package in the same repo)

## Licence

Apache-2.0. See `LICENSE` at the repo root.
