CLI Commands

Triggerfish provides a comprehensive CLI for managing your agent, daemon, channels, and sessions. This page covers every available command and in-chat shortcut.

Core Commands

triggerfish dive

Run the interactive setup wizard. This is the first command you run after installation and can be re-run at any time to reconfigure.

triggerfish dive

The wizard walks through 6 steps: LLM provider, agent name/personality, channel setup, classification mode, skill installation, and daemon installation. See Quick Start for a full walkthrough.

triggerfish chat

Start an interactive chat session in your terminal. This is the default command when you run triggerfish with no arguments.

triggerfish chat

The chat interface features:

• Full-width input bar at the bottom of the terminal
• Streaming responses with real-time token display
• Compact tool call display (toggle with Ctrl+O)
• Input history (persisted across sessions)
• ESC to interrupt a running response
• Conversation compaction to manage long sessions

triggerfish run

Start the gateway server in the foreground. Useful for development and debugging.

triggerfish run

The gateway manages WebSocket connections, channel adapters, the policy engine, and session state. In production, use triggerfish start to run as a daemon instead.

triggerfish start

Install and start Triggerfish as a background daemon using your OS service manager.

triggerfish start

Platform	Service Manager
macOS	launchd
Linux	systemd
Windows	Windows Service / Task Scheduler

The daemon starts automatically on login and keeps your agent running in the background.

triggerfish stop

Stop the running daemon.

triggerfish stop

triggerfish status

Check whether the daemon is currently running and display basic status information.

triggerfish status

Example output:

Triggerfish daemon is running
  PID: 12345
  Uptime: 3d 2h 15m
  Channels: 3 active (CLI, Telegram, Slack)
  Sessions: 2 active

triggerfish logs

View the daemon log output.

# Show recent logs
triggerfish logs

# Stream logs in real time
triggerfish logs --tail

triggerfish patrol

Run a comprehensive health check of your Triggerfish installation.

triggerfish patrol

Example output:

Triggerfish Health Check

  Gateway running (PID 12345, uptime 3d 2h)
  LLM provider connected (Anthropic, Claude Sonnet 4.5)
  3 channels active (CLI, Telegram, Slack)
  Policy engine loaded (12 rules, 3 custom)
  5 skills installed (2 bundled, 1 managed, 2 workspace)
  Secrets stored securely (macOS Keychain)
  2 cron jobs scheduled
  Webhook endpoints configured (2 active)

Overall: HEALTHY

Patrol checks:

• Gateway process status and uptime
• LLM provider connectivity
• Channel adapter health
• Policy engine rule loading
• Installed skills
• Secrets storage
• Cron job scheduling
• Webhook endpoint configuration
• Exposed port detection

triggerfish config

Manage your configuration file.

# Open config in your default editor
triggerfish config edit

# Validate config syntax and values
triggerfish config validate

triggerfish update

Check for available updates and install them.

triggerfish update

triggerfish version

Display the current Triggerfish version.

triggerfish version

Skill Commands

Manage skills from The Reef marketplace and your local workspace.

triggerfish skill search "calendar"     # Search The Reef for skills
triggerfish skill install google-cal    # Install a skill
triggerfish skill list                  # List installed skills
triggerfish skill update --all          # Update all installed skills
triggerfish skill publish               # Publish a skill to The Reef
triggerfish skill create                # Scaffold a new skill

Session Commands

Inspect and manage active sessions.

triggerfish session list                # List active sessions
triggerfish session history             # View session transcript
triggerfish session spawn               # Create a background session

Buoy Commands

Manage companion device connections.

triggerfish buoys list                  # List connected buoys
triggerfish buoys pair                  # Pair a new buoy device

In-Chat Commands

These commands are available during an interactive chat session (via triggerfish chat or any connected channel). They are owner-only.

Command	Description
/help	Show available in-chat commands
/status	Display session status: model, token count, cost, taint level
/reset	Reset session taint and conversation history
/compact	Compress conversation history using LLM summarization
/model <name>	Switch the LLM model for the current session
/skill install <name>	Install a skill from The Reef
/cron list	List scheduled cron jobs

Keyboard Shortcuts

These shortcuts work in the CLI chat interface:

Shortcut	Action
ESC	Interrupt the current LLM response
Ctrl+O	Toggle compact/expanded tool call display
Ctrl+C	Exit the chat session
Up/Down	Navigate input history

TIP

The ESC interrupt sends an abort signal through the entire chain -- from the orchestrator through to the LLM provider. The response stops cleanly and you can continue the conversation.

Quick Reference

# Setup and management
triggerfish dive              # Setup wizard
triggerfish start             # Start daemon
triggerfish stop              # Stop daemon
triggerfish status            # Check status
triggerfish logs --tail       # Stream logs
triggerfish patrol            # Health check
triggerfish config edit       # Edit config
triggerfish update            # Check for updates
triggerfish version           # Show version

# Daily use
triggerfish chat              # Interactive chat
triggerfish run               # Foreground mode

# Skills
triggerfish skill search      # Search The Reef
triggerfish skill install     # Install skill
triggerfish skill list        # List installed
triggerfish skill create      # Create new skill

# Sessions
triggerfish session list      # List sessions
triggerfish session history   # View transcript