Metadata-Version: 2.4
Name: ai-usage-bar-mac
Version: 0.1.1a1
Summary: macOS team companion for AI Usage Bar
Author: noah-traderlab
License-Expression: MIT
Project-URL: Homepage, https://github.com/noah-traderlab/ai-usage-bar-support
Project-URL: Historical archive, https://github.com/noah-traderlab/ai-usage-bar
Project-URL: Issues, https://github.com/noah-traderlab/ai-usage-bar-support/issues
Project-URL: Security, https://github.com/noah-traderlab/ai-usage-bar-support/security/policy
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
Dynamic: license-file

# AI Usage Bar — macOS companion

An early-stage Python companion to the Windows AI Usage Bar application. It joins an existing team and reports Claude Code/Codex usage to a shared folder. The administrator dashboard is part of the separate Windows application.

This source prepares **0.1.1a1**, an alpha candidate. It is not a statement that this version has been published. Requires Python 3.11 or newer. The optional GUI requires Tk support; macOS GUI behavior on end-user machines remains unverified. Linux and Windows can run synthetic checks, but their native desktop integration is not supported by this companion.

## Install a local candidate and inspect it

Use the exact wheel whose source and digest you have checked. These commands install that local file without contacting a package index:

```sh
python3 -m venv .venv
.venv/bin/python -m pip install --no-index --no-deps path/to/ai_usage_bar_mac-0.1.1a1-py3-none-any.whl
.venv/bin/aiusagebar --help
```

On Windows, the equivalent executables are under `.venv\Scripts\`. Installation and `--help` do not join a team or start the GUI.

To inspect saved sharing settings without showing personal values:

```sh
.venv/bin/aiusagebar status --sharing
```

This reads the local participation settings, which can contain a private key, but does not use or display that key. It shows the saved participation state, consent ceiling, and names of information that may be shared. It does not read raw logs, authentication data, or the shared folder, and does not send reports or save settings. The current effective sharing scope remains unverified; friends settings are separate. See the bundled `docs/sharing-status.md`. Ordinary `status` may display personal values; the joined GUI retains automatic reporting.

## Source and repeatable checks

The source distribution includes this companion's runtime source, three synthetic test files (15 regression methods and 36 selftest checks), the packaging verifier, licenses, and verification instructions in `docs/python-package-release.md`. Test fixtures are generated locally. The wheel contains runtime code and metadata; obtain the matching source distribution to repeat the checks. Neither artifact includes the Windows application or its tests.

With the documented build tools already installed, unpack the source distribution and run its verifier against that same archive. It rebuilds from the archive, installs into a temporary environment without an index, checks the imported code's location, and runs the synthetic checks. A skipped regression is an incomplete result, not a full pass. This does not verify the macOS GUI or establish a security audit.

Active development remains in the private `noah-traderlab/ai-project` repository. The [historical source archive](https://github.com/noah-traderlab/ai-usage-bar) preserves earlier source and releases; it does not represent this candidate. No new public source URL is claimed here. For a future published version, its matching source distribution and recorded digest identify the packaged source.

## Differences from published 0.1.0

[PyPI 0.1.0](https://pypi.org/project/ai-usage-bar-mac/0.1.0/) was published on 2026-10-27 from revision `da925a41fdaf23687c7502c33eeb48895ee7d49d`. It does not include `status --sharing` or the later consent display, support links, and source-distribution checks in this candidate. Existing Windows releases and Mac app previews are separate artifacts. A successful check of an earlier candidate is not a result for 0.1.1a1.

## Privacy, reporting, and license

Joining is optional and requires explicit consent. Team reports can include machine/user identifiers, email, token usage, session titles, working directories, activity times, and prompt text from recent Claude Code/Codex sessions. Read the sharing guide and join consent before using `join --yes`. Reports are encrypted for the team administrator; the administrator and shared-folder permissions still need to be trusted. Use `leave` to stop team participation. The optional friends feature is separate and off by default.

Use the [support repository](https://github.com/noah-traderlab/ai-usage-bar-support/issues/new/choose) for ordinary bugs or installation questions, and the [private reporting form](https://github.com/noah-traderlab/ai-usage-bar-support/security/advisories/new) for suspected vulnerabilities. Private reporting requires a GitHub account; read the [reporting policy](https://github.com/noah-traderlab/ai-usage-bar-support/blob/main/SECURITY.md) first. Do not put private logs, keys, personal information, or vulnerability details in public posts.

Maintained by [noah-traderlab](https://github.com/noah-traderlab). MIT licensed; see the bundled license and third-party notices. Investigation and implementation can use AI assistance with recorded checks. This is an independent project and is not affiliated with Anthropic or OpenAI.
