fluq — AI Agent Observer CLI

Watch your AI agents running in tmux sessions. Zero code changes required.

Install

npm install -g fluq

Quick Start

# Set your API key
export FLUQ_API_KEY=fo_your_key_here

# Start watching all tmux sessions
fluq watch

# Or pass the key directly
fluq watch --api-key fo_your_key_here

Commands

fluq watch

Auto-discovers tmux sessions, detects AI agent activity (Claude Code, Codex, OpenClaw, etc.), and reports events to Fluq.

fluq watch                          # Watch all tmux sessions
fluq watch --session crank-alpha    # Watch specific session
fluq watch --exclude test           # Exclude sessions matching pattern
fluq watch --interval 5000          # Poll every 5 seconds
fluq watch --dry-run                # Print events without sending
fluq watch --verbose                # Debug output

fluq status

Check connection to the Fluq API.

fluq status --api-key fo_your_key_here

What it detects

• Agent types: Claude Code, Codex, OpenAI CLI, OpenClaw, generic AI agents
• Events: file reads/writes, API calls, tool usage, errors, completions, spawns, token counts
• Traces: Automatically creates traces per session, links parent→child on spawn

Configuration

| Option | Env var | Default | |--------|---------|---------| | --api-key | FLUQ_API_KEY | — | | --endpoint | FLUQ_ENDPOINT | https://fluq.ai | | --interval | — | 3000 |

Agent IDs are cached in ~/.fluq/agents.json to avoid re-registration.