frontline-agents

Manage Frontline AI agents, flows, conversations, and analytics via the Frontline CLI.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/api-evangelist/frontline --skill frontline-agents-api-evangelist
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: frontline-agents
Source: https://github.com/api-evangelist/frontline/tree/main/skills/vendor/frontline-agents
Command: npx skills add https://github.com/api-evangelist/frontline --skill frontline-agents-api-evangelist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @getfrontline/cli.

What problem does it solve? Managing Frontline AI agents through a web UI is slow for repetitive tasks like creating flows, editing graph nodes, testing agents, and reviewing conversation transcripts. This Skill lets you perform all of those operations directly from the terminal using the Frontline CLI. ## Core Features & Use Cases - Agent Lifecycle Management: Create, update, deploy, and soft-delete agents, and manage agent settings, themes, channels, variables, and intents with JSON payloads validated by the API. - Flow Graph Editing: Build and inspect flow graphs node by node, with support for node types like START, SAY_AI, RESPONSE_AI, TOOLS_AI, API, and CONDITIONAL_ROUTING, plus edge validation rules. - Testing and Observability: Run an agent end-to-end over the OVERVIEW channel, list and search conversations, read clean or debug transcripts, trace individual messages, and pull analytics by date range. - Use Case: You need to test a new support agent before launch. Create the agent, build a flow with a START and SAY_AI node, run a test conversation with frontline agents run, then review the transcript and trace any unexpected replies. ## Quick Start Ask the AI to list all active Frontline agents as a table and then run a test message against one of them.

Frequently Asked Questions about frontline-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test a Frontline AI agent from the terminal?▼

Use frontline agents run with an optional --message flag to send a message and get the agent's reply over the OVERVIEW channel. It runs against the agent's active or draft flow, and returns a conversation_id you can use to continue the conversation.

How do I create a flow with nodes using the Frontline CLI?▼

Select an agent with frontline agents use, create a flow with frontline agents flows create, then add nodes with frontline agents flows nodes create and connect them with frontline agents flows edges add. Do not send nodeId or alias on create since the server assigns both.

What node types does the Frontline flow builder support?▼

Supported types are START, TRIGGER_INTENT, SAY_AI, RESPONSE_AI, TOOLS_AI, API, CONDITIONAL_ROUTING, and CREATE_RECORD_ACTIVITY. DYNAMIC_TABLES is automation-only and returns a 400 error if added to a flow.

Why does frontline agents commands fail with no API key found?▼

This error means the CLI is not authenticated. Run frontline auth login to store credentials, and note that mutating commands require a USER API key. Use --debug to inspect the full HTTP request and response for further diagnosis.

Can I read production conversation transcripts with the Frontline CLI?▼

Yes, frontline agents conversations lists and searches conversations, and the get subcommand returns a clean transcript of user-facing messages. Add --include-events for a debug view with flow events, and use conversations trace for a single message's full audit log.