Skip to content
Merged
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@ node_modules/
dist/
.DS_Store
*.tgz
.worktrees/
57 changes: 56 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ CLI & Agent Skill for managing Slack Enterprise Grid / Business+ workspaces via

## Features

- **107 admin commands** covering 15 API groups: teams, users, conversations, apps, invite-requests, workflows, functions, scim-users, scim-groups, auth-policy, barriers, emoji, roles, usergroups, and token management
- **130 commands** covering admin.\* and standard Slack APIs: teams, users, conversations, apps, invite-requests, workflows, functions, scim-users, scim-groups, auth-policy, barriers, emoji, roles, usergroups, and token management
- **Agent Skill** — ships with a Claude Code / Codex skill so AI agents can drive Slack admin tasks using the CLI as a tool
- **Bulk operations** — archive, delete, or move hundreds of channels at once with `conversations bulk-*`
- **Output formats** — table (human), JSON (programmatic), TSV (pipe-friendly)
Expand Down Expand Up @@ -322,6 +322,44 @@ sladm teams list --plain # TSV (for scripting)
| `usergroups add-teams` | Add teams to a usergroup |
| `usergroups list-channels` | List default channels of a usergroup |
| `usergroups remove-channels` | Remove default channels from a usergroup |
| `usergroups list` | List usergroups |
| `usergroups create` | Create a usergroup |
| `usergroups update` | Update a usergroup |
| `usergroups enable` | Enable a usergroup |
| `usergroups disable` | Disable a usergroup |
| `usergroups users list` | List members of a usergroup |
| `usergroups users update` | Update members of a usergroup |

### Users (non-admin)

| Command | Description |
|---------|-------------|
| `users info` | Get user info (`users.info`) |
| `users lookup-by-email` | Look up user by email (`users.lookupByEmail`) |
| `users get-presence` | Get user presence (`users.getPresence`) |
| `users set-presence` | Set user presence (`users.setPresence`) |
| `users conversations` | List user's conversations (`users.conversations`) |
| `users identity` | Get caller's identity (`users.identity`) |
| `users profile get` | Get user profile (`users.profile.get`) |
| `users profile set` | Set user profile fields (`users.profile.set`) |

### Conversations (non-admin)

| Command | Description |
|---------|-------------|
| `conversations list` | List channels (`conversations.list`) |
| `conversations info` | Get channel info (`conversations.info`) |
| `conversations members` | List channel members (`conversations.members`) |

### Teams (non-admin)

| Command | Description |
|---------|-------------|
| `teams info` | Get team info (`team.info`) |
| `teams profile get` | Get team profile (`team.profile.get`) |
| `teams billable-info` | Get billable info per user (`team.billableInfo`) |
| `teams access-logs` | Get access logs (`team.accessLogs`) |
| `teams integration-logs` | Get integration logs (`team.integrationLogs`) |

## Required Scopes

Expand All @@ -341,6 +379,23 @@ sladm teams list --plain # TSV (for scripting)
| `admin.workflows:write` | Manage workflows, set permissions |
| `admin` | SCIM user and group management |

### Non-admin API Scopes

| Scope | Purpose |
|-------|---------|
| `users:read` | User info, presence, conversations |
| `users:read.email` | Look up user by email |
| `users.profile:read` | Read user profile |
| `users.profile:write` | Update user profile |
| `channels:read` | List public channels, get channel info/members |
| `groups:read` | Private channel info/members |
| `mpim:read` | Multi-party DM info/members |
| `im:read` | DM info/members |
| `usergroups:read` | List and read usergroups |
| `usergroups:write` | Create, update, enable, disable usergroups |
| `team:read` | Team info and profile |
| `admin` (user token) | `team.accessLogs` and `team.billableInfo` require admin privilege |

## Development

```bash
Expand Down
57 changes: 56 additions & 1 deletion README_ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Slack Enterprise Grid / Business+ ワークスペースの `admin.*` API を操

## Features

- **107の管理コマンド** — teams, users, conversations, apps, invite-requests, workflows, functions, scim-users, scim-groups, auth-policy, barriers, emoji, roles, usergroups, token の15グループをカバー
- **130コマンド** — admin.\* および標準 Slack API をカバー: teams, users, conversations, apps, invite-requests, workflows, functions, scim-users, scim-groups, auth-policy, barriers, emoji, roles, usergroups, token
- **Agent Skill** — Claude Code / Codex のスキルとして動作し、AI エージェントが CLI 経由で Slack 管理操作を実行可能
- **一括操作** — `conversations bulk-*` で数百チャンネルのアーカイブ・削除・移動を一発実行
- **出力形式** — テーブル(人間向け)、JSON(プログラム連携)、TSV(パイプ向け)
Expand Down Expand Up @@ -322,6 +322,44 @@ sladm teams list --plain # TSV 形式(スクリプト連携向け)
| `usergroups add-teams` | ユーザーグループにチーム追加 |
| `usergroups list-channels` | ユーザーグループのデフォルトチャンネル一覧 |
| `usergroups remove-channels` | ユーザーグループからデフォルトチャンネル削除 |
| `usergroups list` | ユーザーグループ一覧 |
| `usergroups create` | ユーザーグループ作成 |
| `usergroups update` | ユーザーグループ更新 |
| `usergroups enable` | ユーザーグループ有効化 |
| `usergroups disable` | ユーザーグループ無効化 |
| `usergroups users list` | ユーザーグループのメンバー一覧 |
| `usergroups users update` | ユーザーグループのメンバー更新 |

### Users(非 admin)

| コマンド | 説明 |
|---------|------|
| `users info` | ユーザー情報取得(`users.info`) |
| `users lookup-by-email` | メールでユーザー検索(`users.lookupByEmail`) |
| `users get-presence` | ユーザーのプレゼンス取得(`users.getPresence`) |
| `users set-presence` | 自身のプレゼンス設定(`users.setPresence`) |
| `users conversations` | ユーザーが参加しているチャンネル一覧(`users.conversations`) |
| `users identity` | 呼び出し元のユーザー情報取得(`users.identity`) |
| `users profile get` | ユーザープロフィール取得(`users.profile.get`) |
| `users profile set` | ユーザープロフィール更新(`users.profile.set`) |

### Conversations(非 admin)

| コマンド | 説明 |
|---------|------|
| `conversations list` | チャンネル一覧(`conversations.list`) |
| `conversations info` | チャンネル情報取得(`conversations.info`) |
| `conversations members` | チャンネルメンバー一覧(`conversations.members`) |

### Teams(非 admin)

| コマンド | 説明 |
|---------|------|
| `teams info` | チーム情報取得(`team.info`) |
| `teams profile get` | チームプロフィール取得(`team.profile.get`) |
| `teams billable-info` | 課金対象ユーザー情報取得(`team.billableInfo`) |
| `teams access-logs` | アクセスログ取得(`team.accessLogs`) |
| `teams integration-logs` | インテグレーションログ取得(`team.integrationLogs`) |

## Required Scopes

Expand All @@ -341,6 +379,23 @@ sladm teams list --plain # TSV 形式(スクリプト連携向け)
| `admin.workflows:write` | ワークフロー管理・権限設定 |
| `admin` | SCIM ユーザー・グループ管理 |

### 非 admin API 用スコープ

| スコープ | 用途 |
|---------|------|
| `users:read` | ユーザー情報・プレゼンス・会話一覧 |
| `users:read.email` | メールアドレスでユーザー検索 |
| `users.profile:read` | ユーザープロフィール取得 |
| `users.profile:write` | ユーザープロフィール更新 |
| `channels:read` | パブリックチャンネルの一覧・情報・メンバー取得 |
| `groups:read` | プライベートチャンネルの情報・メンバー取得 |
| `mpim:read` | グループDMの情報・メンバー取得 |
| `im:read` | DMの情報・メンバー取得 |
| `usergroups:read` | ユーザーグループ一覧・取得 |
| `usergroups:write` | ユーザーグループ作成・更新・有効化・無効化 |
| `team:read` | チーム情報・プロフィール取得 |
| `admin`(user token) | `team.accessLogs` / `team.billableInfo` には管理者権限が必要 |

## Development

```bash
Expand Down
Loading
Loading