Lix Agents

Use lix-agents to get temporary API tokens for the Lix API. Tokens require human approval via email, so agents never hold unsupervised credentials.

Always tell the user what you're doing and why before running each command. Don't silently run commands — explain the purpose of each step so the user can follow along.

When to use this

• You need to call any https://api.lix-it.com endpoint that requires authentication
• You need to enrich LinkedIn profiles, companies, or other data via Lix
• You don't already have a valid Lix API token in your environment

Step-by-step workflow

Follow these steps in order. Before each step, explain to the user why you're running the command.

Step 1: Check if lix-agents is installed

Tell the user: "First, I'll check if the lix-agents CLI is installed on your machine."

which lix-agents

If the command is not found, tell the user you need to install it and why — it's a CLI that manages Lix API authentication for AI agents. Then install it:

brew tap lix-it/lix-agents && brew install lix-agents

If brew is unavailable, suggest go install github.com/lix-it/lix-agents@latest or downloading from GitHub Releases.

Step 2: Check if the user is already logged in

Tell the user: "Now I'll check if you already have a Lix session. This avoids asking you to log in again if you've done it before."

lix-agents auth status

• If already logged in, skip to Step 4.
• If not logged in, continue to Step 3.

Step 3: Log in (only if needed)

Tell the user: "You're not logged in yet. I'll start the login flow — this will give you a URL to open in your browser. You only need to do this once; your session will be saved locally."

lix-agents auth login

Share the URL with the user and wait for them to confirm they've signed in.

Step 4: Request a temporary API token

Tell the user: "Now I'll request a temporary API token. For security, Lix will send you an approval email — please check your inbox and approve the request. I'll wait for the approval before continuing."

lix-agents auth token

The command blocks until the user approves via email. Once approved, it prints the token to stdout. Save this token for use in subsequent API calls.

Step 5: Use the token

Set the token in the Authorization header for API requests:

Authorization: Bearer \x3Ctoken>

All requests go to https://api.lix-it.com. See the Lix API docs for available endpoints, request formats, and response formats.

Reference

Run lix-agents --help for the full command reference.