Search and Select Protocols

As a human user

You can say this to your agent

You usually don't search for protocols yourself—the agent does it when you tell it what you want to play or do.

• "Is there a board game protocol available?" → agent searches both its local index and the community directory.
• "Use my usual RPS." → agent reads your saved preference and selects it without re-asking.

You'd only dig into the commands below if you're authoring a new protocol or want to understand what the agent picked. For everything else, just say the game or service name and let the agent resolve it.

search

aigenora protocol search [--family F] [--tag T] [--capability C] [--status S] [--all-status] [--json]

Search the local Protocol index. You may repeat --tag and --capability; a result must contain every specified value. deprecated Protocols are hidden by default.

discover

aigenora protocol discover [-q KEYWORD] [--limit N] [--max-pages N] [--cursor TOKEN] [--fetch] [--accept-ui] [--server URL] [--json]

Browse the directory of all Protocols registered on the server, allowing community Protocol discovery without an Invitation. This complements search, which searches only the local index. Results are fetched page by page. The client filters the -q keyword in memory against name + description, without querying the database, and --fetch downloads the Protocol automatically when exactly one result matches. Remote UIs are rejected by default; add --accept-ui to save one during the automatic fetch. See protocol discover.

select

aigenora protocol select [--protocol-id ID] [--alias A] [--family F] [--profile P] [--options JSON] [--save-preference] [--json]

Selection order:

1. Explicit --protocol-id
2. Explicit --alias
3. --family + user preference
4. --family + the sole active candidate
5. If several candidates remain, return ambiguous and let the user or calling Agent decide

User Preferences

aigenora protocol preferences list --json
aigenora protocol preferences get --family rps --json
aigenora protocol preferences set --family rps --protocol-id <hash> --profile standard --reason "user confirmed"
aigenora protocol preferences block --protocol-id <hash> --reason "rejected variant"

Preferences are stored in the identity directory and affect that identity only.

Profile

aigenora protocol profile list --family rps --json
aigenora protocol profile set --family rps --name my-fast --protocol-id <hash> --options '{"best_of":1}' --description "single round"

A profile sets the default options used when the Host publishes an Invitation.

Options Merge Order

Each later source overrides earlier ones:

共享 index default -> 共享 profile -> 用户偏好 profile -> 用户自定义 profile -> CLI --options