Metadata-Version: 2.4
Name: mccloud-assistant
Version: 0.2.7
Summary: McCloud — personal AI assistant TUI
Author: stephen-daq
License: MIT
Project-URL: Homepage, https://github.com/stephen-daq/my-chief-of-staff
Project-URL: Repository, https://github.com/stephen-daq/my-chief-of-staff
Keywords: tui,terminal,ai,assistant,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Terminals
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: textual>=0.83.0
Requires-Dist: anthropic>=0.40
Requires-Dist: slack_sdk>=3.0
Provides-Extra: server
Requires-Dist: fastapi>=0.100; extra == "server"
Requires-Dist: uvicorn>=0.20; extra == "server"

# mccloud

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

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

## Install

```sh
pipx install mccloud-assistant
```

### From source

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

## TUI

```sh
mccloud
```

## CLI

All commands work without opening the TUI.

### Auth status

```sh
mccloud status
```

### Slack

```sh
# 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 (full content)
mccloud threads --recent 5         # show only the 5 most recent
mccloud threads --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

```sh
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

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

### Reminders

```sh
mccloud reminders                  # list incomplete reminders
mccloud reminders add "Call Alex" --due 2026-05-22 --notes "re: Q3 plan"
mccloud reminders done 2           # mark index 2 complete
mccloud reminders delete 2         # delete index 2
```

## Claude Code integration

McCloud ships a [Claude Code](https://claude.ai/code) skill that lets Claude read and act on your real data directly from any conversation.

### Install the skill

```sh
mccloud install-claude
```

This copies the skill into `~/.claude/skills/mccloud/`. Restart Claude Code (or start a new session) to activate it. The skill auto-updates whenever you run `mccloud` after a `pipx upgrade`.

### Available skills

Once installed, use these in any Claude Code session:

| Skill | What it does |
|---|---|
| `/mccloud overview` | Prioritized briefing: overdue reminders, today's calendar, open PRs, recently merged |
| `/mccloud update reminders` | Converts active Slack threads into reminders, then marks threads done |
| `/mccloud what now` | Opinionated recommendation on what to focus on right now |

You can also ask Claude naturally — "what's on my calendar this week", "add a reminder to...", "show me my Slack threads" — and it will use the mccloud CLI automatically.

## 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
- **GitHub** — OAuth
- **Google Calendar** — OAuth

Credentials are stored locally at `~/.mccloud/`.
