Fyzz Chat API

When you need to access the user's Fyzz Chat conversations or projects, use the fyzz-api CLI tool. The tool reads the API key from the PAL_FYZZ_API_KEY environment variable automatically — never attempt to read, print, or reference the API key or the env var directly.

Available commands

List conversations

pal cli skill run fyzz-chat-api fyzz-api -- conversations [--limit 20] [--search "query"] [--project-id <id>] [--cursor <cursor>]

Get a single conversation with messages

pal cli skill run fyzz-chat-api fyzz-api -- conversations <conversation-id>

List projects

pal cli skill run fyzz-chat-api fyzz-api -- projects

Setup

If the tool reports a missing API key:

1. Ask the user to create one in Fyzz Chat → Settings → API Keys
2. They should set PAL_FYZZ_API_KEY in their shell profile or in PAL's settings.json env section
3. Optionally set PAL_FYZZ_BASE_URL (defaults to http://localhost:3000)

Guidelines

• The API key is never visible in this conversation — that is by design
• Use --search for keyword-based lookup across titles and message content
• Use --project-id to scope results to a specific project
• Paginate with --cursor using the cursor from the previous response's meta.cursor field
• For large conversations, consider whether you need all messages or just the metadata (list mode returns titles only)