> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fased.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# directory

# `fased directory`

Use `directory` when you need stable IDs for contacts, groups, or the current
account on a channel that exposes directory data.

## Common flags

* `--channel <name>`: channel id/alias. Required when multiple channels are
  configured; automatic when only one is configured.
* `--account <id>`: account id (default: channel default)
* `--query <text>`: filter peer/group list results when supported
* `--limit <n>`: cap peer/group list results
* `--json`: output JSON

## Notes

* `directory` is meant to help you find IDs you can paste into other commands (especially `fased message send --target ...`).
* For many channels, results are config-backed (allowlists / configured groups) rather than a live provider directory.
* Default output is a compact table; use `--json` for scripting.
* If a channel adapter does not expose self, peers, groups, or members, the
  command reports that the directory capability is unsupported for that channel.

## Using results with `message send`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased directory peers list --channel slack --query "U0"
fased message send --channel slack --target user:U012ABCDEF --message "hello"
```

## ID formats (by channel)

* WhatsApp: `+15551234567` (DM), `1234567890-1234567890@g.us` (group)
* Telegram: `@username` or numeric chat id; groups are numeric ids
* Slack: `user:U…` and `channel:C…`
* Discord: `user:<id>` and `channel:<id>`
* Matrix: `user:@user:server`, `room:!roomId:server`, or `#alias:server`
* Microsoft Teams: `user:<id>` and `conversation:<id>`
* Zalo: user id (Bot API)
* Zalo Personal / `zalouser`: thread id (DM/group) from `zca` (`me`, `friend list`, `group list`)

## Self (“me”)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased directory self --channel zalouser
```

## Peers (contacts/users)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased directory peers list --channel zalouser
fased directory peers list --channel zalouser --query "name"
fased directory peers list --channel zalouser --limit 50
```

## Groups

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fased directory groups list --channel zalouser
fased directory groups list --channel zalouser --query "work"
fased directory groups members --channel zalouser --group-id <id>
```