AI Chat

Workhog's AI chat is powered by Claude and has direct access to your workspace. It reads files, executes tools, and generates outputs — all in real-time.

Starting a Conversation

Type a message in the chat input at the bottom of the screen. The AI agent responds with text and may execute tool calls — real operations like searching files, reading documents, or running calculations. You'll see these tool calls appear inline as the agent works.

Every conversation happens within your workspace scope (workspaces/your-user-id/). The agent can search, read, and write files, but only within your workspace — never outside it.

Model Tiers

Click the model selector in the chat input bar to choose your AI model. Each tier is optimized for different workloads:

Fast
Efficient

Quick answers and rapid iteration. Best for simple lookups, file searches, and light formatting tasks.

Good for:

"What files do I have?"

"Rename invoice.csv to q4-invoice.csv"

"What format is this date?"

Balanced
Default

The everyday workhorse. Handles document analysis, data processing, and multi-step operations well.

Good for:

"Summarize this PDF"

"Extract all line items from invoices/"

"Create a CSV summary of payroll data"

Max
Heavy-duty

Most capable. Use for complex financial analysis, multi-source reports, tax form filling, and dashboard building.

Good for:

"Fill Form 1120 from my P&L data"

"Draft a multi-source quarterly report"

"Analyze 50 invoices and flag anomalies"

Tip

When in doubt, use Balanced. Only switch to Max for tasks that involve complex analysis or multi-step generation. Fast is great for quick lookups when you don't need deep reasoning.

Multi-Tab Sessions

Workhog supports multiple chat tabs — like browser tabs for conversations. Each tab is an independent session with its own context and streaming state.

  • Click the + tab to start a new conversation
  • Each tab can use a different model tier
  • Background tabs continue streaming even when you switch away
  • Close a tab when you're done — the conversation is saved to your chat history

Multi-tab is useful when you're working on different topics simultaneously — e.g., analyzing invoices in one tab while building a report in another.

File Attachments

Attach files to your message to give the agent direct access to their content:

  1. Click the + button next to the chat input
  2. Choose "From workspace" to select an existing file, or "Upload" for a new file
  3. The file appears as an attachment badge above the input
  4. Type your message and send — the agent receives the file content inline

Tip

Attachments work great for providing context, but for spreadsheet data, the CSV Inspector is even better — it gives Claude cell-level precision instead of the entire file.

Tool Calls

As the agent works, you'll see tool call blocks appear in the conversation. These represent real operations the agent is performing:

workspace_searchSearching for files by name or content
workspace_retrieveReading a file from your workspace
workspace_list_foldersBrowsing your folder structure

Running tools appear in a sticky bar at the top. Completed tools collapse into compact cards in the message flow.

Prompt Supercharger

The Prompt Supercharger is a built-in tool that helps you write better prompts. Access it from the toolbar:

  1. Type a rough draft in the chat input
  2. Click the Supercharger icon in the toolbar
  3. The AI analyzes your draft and suggests improvements
  4. It's a multi-turn conversation — keep refining until you're satisfied
  5. Click "Use this prompt" to insert the refined version into chat

Next Steps

AI Chat - Workhog Help