A secure, fast terminal UI client for Microsoft Teams messaging, built in Rust with ratatui.

⚠️ Here be dragons! ttyms is in alpha — part experiment, part playground, part "what if Teams lived in a terminal?" fever dream. Things may break, features may vanish, and your terminal might judge your meeting schedule. Use at your own risk (and enjoyment). 🐉

📋 Legal fine print: This is a personal side project with zero affiliation to Microsoft. No Microsoft engineers were harmed in the making of this tool. All trademarks belong to their respective owners — I just really like terminals. ⚖️

• 1:1 and group chat messaging — browse all your Teams chats, read messages, and reply
• Teams & Channels — browse joined teams, navigate channels, read and post channel messages
• Channel member list — toggle member sidebar with m to see who's in the channel (owners marked with 👑)
• Reply to messages — quote-reply to any message with r key
• Edit & delete messages — edit your own messages with w, delete with d
• Message pagination — scroll up to load older messages automatically
• Reactions — view message reactions (👍❤️😂😮😢😡) and react with keyboard shortcut
• Presence — see online status of contacts, set your own presence (Available, Busy, DND, Away)
• Unread indicators — unread message counts per chat, total unread badge in header
• Rich text rendering — bold, italic, code, and links rendered with terminal formatting
• Beautiful TUI — clean terminal interface with tabbed views, panels, color-coded messages
• Command palette — Ctrl+P fuzzy-find across chats, channels, and actions
• Message search — full-text search across all chats via / key
• Chat management — rename group chats, add/remove members, leave chats
• File sharing — upload and share files (up to 4 MB) in chats and channels via f key
• Image previews — image attachments show inline decoded terminal previews (grayscale block rendering) with Enter-to-open
• Settings dialog — configurable refresh interval via in-app settings
• Delta-based sync — incremental message updates for efficient polling
• Troubleshooting logs — writes non-PII lifecycle/error events to a standard per-user log file
• Secure by design — tokens stored in OS credential manager, sensitive data zeroized in memory
• Auto-refresh — messages update automatically every 15 seconds with terminal bell for new messages
• Vim-style navigation — use j/k or arrow keys to navigate
• Mouse support — click to select chats/teams/channels, scroll messages, focus panels

• Microsoft 365 account with Teams access (work or school account required — personal Microsoft accounts are not supported by the Teams Graph API)

brew install davidkaya/tap/ttyms

cargo install ttyms

# Using an AUR helper (e.g., yay, paru)
yay -S ttyms      # stable release from crates.io
yay -S ttyms-git  # latest from git

git clone https://github.com/davidkaya/ttyms.git
cd ttyms
cargo build --release
# Binary at target/release/ttyms

ttyms ships with a default Azure AD client ID, so it works out of the box — no app registration required.

Just run it:

ttyms

On first run, you'll be prompted to sign in using the device code flow.

A config file is created on first run at:

• Windows: %APPDATA%\ttyms\config.toml
• macOS: ~/Library/Application Support/ttyms/config.toml
• Linux: ~/.config/ttyms/config.toml

You can override the default client ID with your own Azure AD app registration:

client_id = "your-application-client-id-here"
tenant_id = "common"

Device Code Flow (default) — displays a code, you sign in via browser:

cargo run

PKCE Browser Flow — browser opens automatically, redirects to localhost:

cargo run -- --pkce

When a message is selected (s key), press e to open the reaction picker:

• ←/→ to choose emoji: 👍 ❤️ 😂 😮 😢 😡
• Enter to react
• Esc to cancel

Press p to set your status:

• ↑/↓ to select: 🟢 Available, 🔴 Busy, ⛔ DND, 🟡 Away, ⚫ Offline
• Enter to set
• Esc to cancel

ttyms --help              # Show help
ttyms --pkce              # Use PKCE browser flow instead of device code
ttyms --logout            # Clear stored credentials securely
ttyms --client-id <ID>    # Override client_id from config

ttyms writes troubleshooting logs to a per-user file and only logs predefined event labels (no message text, user identifiers, tokens, URLs, or other PII). Coverage includes startup/auth, Graph request outcomes, async refresh/presence flows, file sharing, and image preview queue/download/decode stages.

• Windows: %LOCALAPPDATA%\ttyms\logs\ttyms.log
• macOS: ~/Library/Logs/ttyms/ttyms.log
• Linux: $XDG_STATE_HOME/ttyms/logs/ttyms.log (fallback: ~/.local/state/ttyms/logs/ttyms.log)

# Debug build
cargo build

# Release build (optimized)
cargo build --release

MIT