slackcli

# slackcli

Command-line interface for Slack API operations.

## First Step: Check Configuration

**Run `slack config` at the start of every session** to check workspace setup:

```bash
slack config
```

Check the last line of output:
- `Using org from SLACK_ORG: <name>` → No `--org` needed, commands use this workspace
- `No org selected (use --org or SLACK_ORG)` → Must pass `--org=<workspace>` to every command

The output also shows available workspaces in the "orgs" section.

## Workspace Selection

```bash
# When SLACK_ORG env is set (no --org needed):
slack conversations list

# When no org is selected (--org required):
slack --org=mycompany conversations list
```

If the user hasn't specified a workspace and no default is configured, **ask them which workspace to use** (show the available orgs from `slack config`).

## Global Options

```bash
slack --org=<workspace>  # Specify workspace (required if SLACK_ORG not set)
slack --verbose          # Enable debug logging
slack --json             # Output as JSON (available on most commands)
```

## Conversations

```bash
slack conversations list              # All conversations (cached)
slack conversations list --public     # Public channels only
slack conversations list --private    # Private channels only
slack conversations list --dms        # DMs and group DMs only
slack conversations list --member     # Channels you're a member of
slack conversations list --non-member # Channels you're not in
slack conversations list --refresh    # Force cache refresh
```

## Messages

### List Messages

```bash
slack messages list '#channel'                    # Recent messages (default limit 100)
slack messages list '#channel' --today            # Today only
slack messages list '#channel' --last-7d          # Last 7 days
slack messages list '#channel' --last-30d         # Last 30 days
slack messages list '#channel' --since 2024-01-15 # Since specific date
slack messages list '#channel' --since 7d --until 3d  # Relative range
s