# Troubleshooting

## `syft` Command Not Found

The CLI is not installed or not available on the current machine.

Guide the user to install it:

```bash
npm install -g @orionarm/syft-cli
```

Then continue with:

```bash
syft login
syft status
```

## The User Has Never Set Up Syft AI

If the user has not created an account or has not set interest topics yet, stop the CLI workflow and direct them to [https://syft.ai](https://syft.ai).

They need to:

1. download and use the Syft AI app
2. create a Syft account
3. set up their interest topics

Only then should they return to the CLI.

## Not Logged In Or Unauthorized

Guide:

```bash
syft login
syft status
```

If the command output indicates authorization failure, tell the user they need to complete login before using search or top-story commands.

## The User Does Not Know Which Command To Use

Use this simple routing:

- `syft following` for followed interests
- `syft top` for top stories in the user's pool
- `syft search "<query>"` for targeted search in the user's pool
- `syft global-search "<query>"` for broader global search

## The User Has No Useful Personal Results Yet

Possible causes:

1. They are not logged in
2. They have not set up interest topics in the Syft AI app
3. They are using the wrong command for the job

Recommended recovery order:

1. `syft status`
2. confirm the user has a Syft AI account
3. confirm they have selected interest topics in the app
4. inspect `syft following`
5. retry with `syft top` or `syft search`

## The User Wants Codex Integration

If the user specifically wants the built-in Syft skill installed in Codex, guide:

```bash
syft install-skill
```

If they only want to use the CLI itself, do not force that step.