owa-tui
owa-tui is a Textual terminal UI front-end for the owa-tools Microsoft 365
CLI suite.
The project is intentionally separate from owa-tools: owa-tui imports only
the stable owa-tools library API and never imports broker internals directly.
Status
Install
uv tool install owa-tui # or: pipx install owa-tui
# or
brew install damsleth/tap/owa-tui
Installing from PyPI pulls in owa-tools and owa-piggy. Set up an
owa-piggy profile before first use.
Usage
owa-tui --help
owa-tui --version
owa-tui
owa-tui cal # or: owa-tui --tool cal
owa-tui mail --profile une # one owa-piggy profile
owa-tui cal -A # merge every eligible profile
owa-tui mail --profile une --profile nc
-A (or --profile all, or --profile given more than once) merges the list
screens (cal, mail, people, tasks, planner, ado, teams) across profiles, using
the same eligibility rule as owa-tools' -A. Rows get a profile column, and
anything you do to a row (respond, reply, mark read, open) runs as that row's
profile. Esc → Switch profile goes back to a single profile.
Running owa-tui starts the Textual shell. No Microsoft Graph or broker calls
are made during startup.
Development
.venv/bin/ruff check .
.venv/bin/python -m compileall -q src
.venv/bin/python -m pytest -q --cov --cov-fail-under=85
uv build
CI (.github/workflows/ci.yml) runs all of the above plus the tui-test e2e
suite on Python 3.10–3.12 for every push to main and every PR.
End-to-end terminal tests (tui-test)
In-process pytest covers widget logic; @microsoft/tui-test
covers the real binary by spawning owa-tui in a pty and asserting on what it
actually renders. Tests live in e2e/.
npm install # one-time
npm run test:e2e # or: npx tui-test
owa-tui must be importable on PATH (e.g. pip install -e .). Traces land in
tui-traces/; replay with npx tui-test show-trace.
A live-Graph smoke runs only when opted in: OWA_TUI_LIVE_E2E=1 npx tui-test e2e/live.test.ts (and OWA_TUI_LIVE_TESTS=1 for the unit-level token smoke).
Releasing
Pushing a v* tag triggers .github/workflows/release.yml: it re-runs the
full gates (lint, compile, coverage, e2e) on Python 3.10–3.12, then uv builds
the wheel/sdist and publishes a GitHub Release. PyPI upload is local
(uv publish); see RELEASING.md. Standalone binaries are deferred, not planned.
Metadata
Release files for owa-tui 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| owa_tui-0.3.0.tar.gz | 121.4 kB | Without provenance | Details for owa_tui-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| owa_tui-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for owa_tui-0.3.0-py3-none-any.whl |
Total release size: 270.1 kB
Release files / owa_tui-0.3.0.tar.gz
| Download URL | owa_tui-0.3.0.tar.gz |
|---|---|
| Size | 121.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e6cc3d9006489b5f94c71bd16380e9fa1219e78faefc8c3ad1ec5fb938f2d0d1
|
|
BLAKE2b-256 checksum How to use checksums |
107d0ee8b0f783f7e82e4f59e607b2ad6ca3135e3f4e0541ebe4df52bf348928
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / owa_tui-0.3.0-py3-none-any.whl
| Download URL | owa_tui-0.3.0-py3-none-any.whl |
|---|---|
| Size | 148.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0edacc415dcbd5bf4da028c0d32d3e80239f8b9629be43bd19d80c180c655a27
|
|
BLAKE2b-256 checksum How to use checksums |
825b92dc09b13b8f66d88c4486bc537aa69126adac01b114ec8dd9f0c9d56aa4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for owa-tui 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.