# Command Guide

Use this guide when the user is ready for the CLI but does not know which command matches the job.

## Quick Map

- `syft following`
  - Use when the user wants to inspect followed topics and interests.

- `syft top`
  - Use when the user wants the top stories from their own Syft news pool.

- `syft search "<query>"`
  - Use when the user wants targeted search inside their own news pool.

- `syft global-search "<query>"`
  - Use when the user wants broader query-based retrieval across the global Syft pool.

- `syft status`
  - Use when the user wants to confirm whether the CLI is installed and authenticated.

- `syft login`
  - Use when the user needs to authenticate.

- `syft install-skill`
  - Use when the user wants the built-in Syft Codex skill installed from the CLI.

## Recommended Guidance Patterns

### Show me what I follow

Recommend:

```bash
syft following
```

### What are the top stories for me right now

Recommend:

```bash
syft top
```

### Search my own Syft news pool

Recommend:

```bash
syft search "AI News"
```

Replace `"AI News"` with the user's actual query.

### Search beyond my own pool

Recommend:

```bash
syft global-search "AI News"
```

### Check if I am logged in

Recommend:

```bash
syft status
```

### Install the built-in Codex skill

Recommend:

```bash
syft install-skill
```

## Topic-Specific Top Stories

If the user wants top stories for a followed topic, first inspect the topic list:

```bash
syft following
```

Then use the topic id:

```bash
syft top --topic-id <id>
```

Use this only after the topic id is known.

## Assistant Style

When helping a user choose commands:

1. Briefly explain why a command fits.
2. Give the exact command.
3. If useful, mention the most likely follow-up command.

Example:

- Use `syft following` first to find the topic id you care about.
- Then run `syft top --topic-id <id>` to view top stories for that topic.