v0.3.0

Jarvis AI Assistant

Jarvis is FacilFlow’s AI-powered assistant that helps you manage pipelines, explore data, and get answers through natural conversation.

Accessing Jarvis

  1. Keyboard shortcut: Press Ctrl+K (or Cmd+K on Mac)
  2. Chat bubble: Click the floating button in the bottom-right corner

Chat Interface

Sending Messages

  1. Type your question or request in the input field
  2. Press Enter or click the send button
  3. Watch as Jarvis streams the response in real-time via SSE

Canceling Requests

Click the Cancel button during streaming to stop the response.

MCP Tools

Jarvis has access to FacilFlow via Model Context Protocol (MCP) tools. These let Jarvis take actions on your behalf:

Pipeline Tools

Tool Description
list_pipelines List all pipelines with status
get_pipeline Get pipeline details by ID
create_pipeline Create a new pipeline from description
start_pipeline Start a stopped pipeline
stop_pipeline Stop a running pipeline
delete_pipeline Delete a pipeline

Query Tools

Tool Description
query_data Run SQL queries against InfluxDB clusters
list_data_sources List available data sources
get_schema Retrieve schema for a data source
explore_tags Browse tags and metadata

Infrastructure Tools

Tool Description
list_clusters List InfluxDB clusters and status
list_agents List edge agents and health
get_agent_status Get detailed agent status

Artifact Rendering

Jarvis generates rich artifacts directly in the chat:

Chart Artifacts

  • Line, bar, area, and pie charts
  • Interactive with hover tooltips

Table Artifacts

  • Sortable columns with formatted values
  • Support for nested objects

Code Artifacts

  • Syntax highlighting by language
  • Copy-to-clipboard button

Mermaid Diagrams

  • Flowcharts, sequence diagrams, ER diagrams, state diagrams

Canvas Panel

When Jarvis generates artifacts, a Canvas Panel opens on the right side:

  • View artifacts in a larger viewport
  • Switch between multiple artifacts using tabs
  • Artifacts persist across the conversation
  • Close the panel with the X button or drag to resize

Example Prompts

Pipeline Management

  • “List all my pipelines”
  • “Create a pipeline that reads OPC-UA data and writes to InfluxDB”
  • “Stop the production pipeline”

Data Exploration

  • “Show me the last 24 hours of temperature readings”
  • “Run SELECT * FROM sensor_data WHERE plant = ‘houston’ LIMIT 100”
  • “What data sources are available?”

Infrastructure

  • “What clusters are running?”
  • “Show me agent status for plant-houston”

Technical Details

Streaming

Jarvis uses Server-Sent Events (SSE) for real-time response streaming. Responses appear token-by-token as they are generated.

Authentication

Jarvis uses Claude Code CLI with OAuth authentication. The backend container mounts ~/.claude from the host to share credentials. If authenticated on the host via claude /login, the container inherits those credentials automatically.

Keyboard Shortcuts

Shortcut Action
Ctrl+K / Cmd+K Open/close Jarvis panel
Enter Send message
Escape Close panel
esc