mccloud-assistant 0.2.2

McCloud — personal AI assistant TUI

mccloud

Personal AI assistant — TUI and CLI, powered by Claude.

Connects Slack threads, GitHub PRs, Google Calendar, and Apple Reminders in one place.

Install

pipx install mccloud-assistant

From source

git clone https://github.com/stephen-daq/mccloud
cd mccloud
make install

TUI

mccloud

CLI

All commands work without opening the TUI.

Auth status

mccloud status

Slack

# Send a DM
mccloud send --to "Name" --message "hello"
mccloud send --to "Name" report.pdf
mccloud send --to "Name" --message "here you go" a.pdf b.pdf
mccloud send --list-users          # see available users

# Threads
mccloud threads                    # list active threads
mccloud threads list --ids         # show IDs (needed for done/delete)
mccloud threads done <id>          # mark complete
mccloud threads delete <id>        # delete
mccloud threads save <slack-url>   # save a thread by message link
mccloud threads new --to "Name" --message "hi"

GitHub PRs

mccloud prs                        # list tracked PRs with live status
mccloud prs --open                 # open PRs only
mccloud prs --no-status            # skip GitHub API (fast)
mccloud prs --refresh              # bypass cache

mccloud track https://github.com/owner/repo/pull/123
mccloud untrack https://github.com/owner/repo/pull/123

Calendar

mccloud calendar                   # today's events
mccloud calendar --week            # this week
mccloud calendar --days 3          # next N days
mccloud calendar --date 2026-05-22

Reminders (macOS only)

mccloud reminders                  # list incomplete reminders
mccloud reminders done 2           # mark index 2 complete
mccloud reminders add "Call Alex" --due 2026-05-21 --list Work

Slack slash commands

Install the mccloud Slack app to use these in any channel:

• /save — save the current thread
• /save <message-link> — save a specific thread
• /track — track the GitHub PR linked in the latest message
• /track <pr-url> — track a specific PR

Connecting integrations

Run mccloud and open the Config tab to connect:

• Slack — OAuth or existing gh CLI session
• GitHub — OAuth or existing gh CLI session
• Google Calendar — OAuth

Credentials are stored locally at ~/.mccloud/.