Skip to main content

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.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for owa-tui 0.3.1
File Size Uploaded Provenance Actions
owa_tui-0.3.1.tar.gz 120.6 kB Without provenance Details for owa_tui-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for owa-tui 0.3.1
File Interpreter ABI Platform Actions
owa_tui-0.3.1-py3-none-any.whl Python 3 none any Details for owa_tui-0.3.1-py3-none-any.whl

Total release size: 269.3 kB

Release files / owa_tui-0.3.1.tar.gz

Download URL owa_tui-0.3.1.tar.gz
Size 120.6 kB
Tags Source
SHA-256 checksum
How to use checksums
95a8c4cab495554909e8cf45543362a3182fcfdc28b9f9af3838b0e3f754b6e3
BLAKE2b-256 checksum
How to use checksums
222427b8c0ff9d912040ef331f23b8b4a3c31b38f408983ce7848c4251a94730
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.1-py3-none-any.whl

Download URL owa_tui-0.3.1-py3-none-any.whl
Size 148.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
66b84ac98a6801a0120b619aa5c0035806679516e465d538beba7b3b5c7920a4
BLAKE2b-256 checksum
How to use checksums
2f483204c7750cfdc9ad5b769427031b4904b082c3d4b3f2dfcc44cfde22b0c7
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.1

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.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page