https://github.com/excelano/checkin-cli
Command-line check-in for Microsoft 365: unread Outlook mail, Teams chats, and next meeting from one Go binary.
https://github.com/excelano/checkin-cli
Last synced: 28 days ago
JSON representation
Command-line check-in for Microsoft 365: unread Outlook mail, Teams chats, and next meeting from one Go binary.
- Host: GitHub
- URL: https://github.com/excelano/checkin-cli
- Owner: excelano
- License: mit
- Created: 2026-05-12T23:46:21.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-25T12:21:11.000Z (about 1 month ago)
- Last Synced: 2026-05-25T14:16:10.246Z (about 1 month ago)
- Language: Go
- Size: 23.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# checkin
Check unread Outlook emails, Teams chats, and your next meeting from the terminal.
## Install
The fastest path on Linux or macOS:
```sh
curl -fsSL https://raw.githubusercontent.com/excelano/checkin-cli/main/install.sh | sh
```
This downloads the latest release binary for your platform, verifies the SHA-256 checksum, and installs it to `/usr/local/bin` (or `~/.local/bin` if `/usr/local/bin` isn't writable). Override the destination with `CHECKIN_INSTALL_DIR=$HOME/bin sh`; pin to a specific tag with `CHECKIN_VERSION=v0.2.4 sh`.
On Debian and Ubuntu, add the [Excelano apt repository](https://excelano.com/apt/) once so updates flow through `apt upgrade`:
```sh
curl -fsSL https://excelano.com/apt/setup.sh | sudo sh
sudo apt install checkin
```
To uninstall: `curl -fsSL https://raw.githubusercontent.com/excelano/checkin-cli/main/uninstall.sh | sh` (or `sudo apt remove checkin` if installed via apt).
### Build from source
```bash
git clone https://github.com/excelano/checkin-cli
cd checkin-cli
go build -o checkin .
mv checkin ~/bin/
```
Requires Go 1.25+.
## Setup
You'll need an Azure app registration before `checkin` can authenticate. Both options below assume you've already installed the binary.
### Option A: Automated (requires Azure CLI)
```bash
curl -fsSL https://raw.githubusercontent.com/excelano/checkin-cli/main/setup.sh -o setup.sh
chmod +x setup.sh
az login
./setup.sh
```
(Or if you installed via apt, `setup.sh` ships at `/usr/share/doc/checkin/setup.sh`.)
### Option B: Manual (Azure portal)
1. Go to [Azure Portal](https://portal.azure.com) → Azure Active Directory → App registrations
2. **New registration**
- Name: `checkin`
- Supported account types: Accounts in this organizational directory only
3. **Authentication** → Add a platform → Mobile and desktop applications
- Check `https://login.microsoftonline.com/common/oauth2/nativeclient`
- Enable **Allow public client flows** (required for device code flow)
- Save
4. **API permissions** → Add a permission → Microsoft Graph → Delegated permissions:
- `User.Read`
- `Mail.ReadWrite`
- `Mail.Send`
- `Calendars.Read`
- `Chat.ReadWrite` ← requires admin consent
5. Copy **Application (client) ID** and **Directory (tenant) ID** from the Overview page
Create the config file:
```bash
mkdir -p ~/.config/checkin
cat > ~/.config/checkin/config.json << 'EOF'
{
"client_id": "YOUR_CLIENT_ID_HERE",
"tenant_id": "YOUR_TENANT_ID_HERE",
"enable_teams": true
}
EOF
```
### Admin Consent
Most enterprise tenants require admin consent for all permissions. Ask your IT admin to grant consent:
```bash
az ad app permission grant --id YOUR_CLIENT_ID --api 00000003-0000-0000-c000-000000000000 --scope "User.Read Mail.ReadWrite Mail.Send Calendars.Read Chat.ReadWrite"
```
Without admin consent, checkin won't be able to authenticate at all in locked-down tenants. If only `Chat.ReadWrite` is blocked, set `"enable_teams": false` in config to use email and calendar without Teams.
## Usage
```
$ checkin
📅 Standup with Tony — in 47 min · 10:30 AM — Online
📧 unread emails (3):
1. Alex K. — "Deck revisions" (10 min ago · 9:42 AM)
2. Jordan R. — "RE: Contract draft" (1 hour ago · 8:53 AM)
3. Newsletter — "Weekly digest" (3 hours ago · 6:48 AM)
💬 pending chats (2):
4. Sam P. — "quick question on timeline" (32 min ago · 9:20 AM)
5. Riley T. — "can you check the numbers" (1 hour ago · 8:51 AM)
Commands:
view message r reply
d mark read (done) x mark all read & quit
r refresh q quit
checkin> 1
(shows full email body)
checkin> r4
Reply in Sam P.:
(end with `.` on a line by itself, or Ctrl-C to cancel)
> Should be ready by EOD tomorrow.
> Let me know if you want to walk through it on a call.
> .
Sent.
checkin> d3
Marked as read: Weekly digest
checkin> x
All marked as read.
```
## Files
- `~/.config/checkin/config.json` — client ID, tenant ID, and enable_teams flag
- `~/.config/checkin/token.json` — cached OAuth token (auto-created)
## Permissions
| Permission | What it does | Admin consent? |
|---|---|---|
| User.Read | Verify authentication | No |
| Mail.ReadWrite | Read and mark-read emails | No |
| Mail.Send | Reply to emails | No |
| Calendars.Read | Show next meeting | No |
| Chat.ReadWrite | Read/reply Teams chats | Yes |