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

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.0
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)

Table of built distributions (wheels) for owa-tui 0.3.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.3.0 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