ttyms — Terminal Microsoft Teams Client

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. ⚖️

Features

• 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
• 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

Screenshots

Prerequisites

• Microsoft 365 account with Teams access

Installation

Homebrew (macOS / Linux)

brew install davidkaya/tap/ttyms

Cargo (all platforms)

cargo install ttyms

Arch Linux (AUR)

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

From source

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

Setup

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.

Configuration (optional)

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"

1. Go to Azure Portal → Microsoft Entra ID → App registrations
2. Click New registration
3. Set:
   • Name: ttyms (or any name)
   • Supported account types: Accounts in any organizational directory (for multi-tenant)
   • Redirect URI: leave blank
4. Click Register
5. Go to Authentication:
   • Enable Allow public client flows → Save
   • Click Add a platform → Mobile and desktop applications
   • Under custom redirect URIs, add: http://localhost → Save
6. Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions:
   • User.Read
   • User.ReadBasic.All
   • Chat.ReadWrite
   • ChatMessage.Read
   • ChatMessage.Send
   • Presence.Read
   • Presence.ReadWrite
   • Team.ReadBasic.All
   • Channel.ReadBasic.All
   • ChannelMessage.Read.All
   • ChannelMessage.Send
   • offline_access
7. Copy the Application (client) ID and set it in your config.toml

Authentication Options

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

Usage

Views

Keyboard Shortcuts (Chats)

Keyboard Shortcuts (Teams)

Reaction Picker

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

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

Presence Picker

Press p to set your status:

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

CLI Options

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

Security

Building

# Debug build
cargo build

# Release build (optimized)
cargo build --release

License

MIT