Frontal Cursor Plugin

Build, deploy, and operate AI agents, workflows, and data pipelines directly from Cursor using the Frontal platform.

---

Features

• Agent Management — Invoke, deploy, test, and debug Frontal AI agents
• AI Inference — Generate text, stream responses, create embeddings via the Frontal AI gateway
• Workflow Orchestration — Create and trigger multi-step workflows with approvals
• Data Pipelines — Build ETL pipelines with collection, transformation, and write stages
• Integration Management — List and inspect tenant integrations
• SDK Guidance — Rules enforce correct @frontal-labs/* SDK usage patterns
• MCP Integration — Direct tool access to Frontal APIs from Cursor's agent

---

Plugin Structure

plugins/frontal/
├── .cursor-plugin/
│   └── plugin.json
├── assets/
│   └── logo.svg
├── rules/
│   ├── frontal-api-conventions.mdc
│   ├── frontal-sdk-usage.mdc
│   └── agent-design-patterns.mdc
├── skills/
│   ├── run-agent/SKILL.md
│   ├── get-invocation/SKILL.md
│   ├── list-integrations/SKILL.md
│   ├── run-inference/SKILL.md
│   ├── manage-workflows/SKILL.md
│   ├── manage-pipelines/SKILL.md
│   ├── manage-graph/SKILL.md
│   ├── manage-blob/SKILL.md
│   ├── manage-functions/SKILL.md
│   └── manage-ontology/SKILL.md
├── agents/
│   ├── frontal-architect.md
│   ├── frontal-debugger.md
│   └── frontal-reviewer.md
├── commands/
│   ├── deploy-agent.md
│   ├── test-agent.md
│   └── check-status.md
├── hooks/
│   └── hooks.json
├── scripts/
│   ├── check-frontal-env.sh
│   └── validate-agent-config.sh
├── mcp.json
└── README.md

---

Getting Started

Prerequisites

Set your Frontal API key:

export FRONTAL_API_KEY=frt_your_key_here

Install from Source (Local Development)

git clone https://github.com/frontal-dev/cursor-plugin
ln -s $(pwd)/cursor-plugin/plugins/frontal ~/.cursor/plugins/local/frontal

Restart Cursor or run Developer: Reload Window.

Install via Team Marketplace

Add this repository URL as a team marketplace in Dashboard > Settings > Plugins > Team Marketplaces.

---

Skills

Skill	Invocation	Description
run-agent	/frontal:run-agent	Invoke a Frontal agent with a task
get-invocation	/frontal:get-invocation	Check agent invocation status
list-integrations	/frontal:list-integrations	List tenant integrations
run-inference	/frontal:run-inference	AI text generation, embeddings, structured output
manage-workflows	/frontal:manage-workflows	Create/trigger/monitor workflows
manage-pipelines	/frontal:manage-pipelines	Create/trigger/monitor data pipelines
manage-graph	/frontal:manage-graph	Graph entities, relationships, semantic search
manage-blob	/frontal:manage-blob	Upload, download, signed URLs, streaming
manage-functions	/frontal:manage-functions	Deploy and invoke serverless functions
manage-ontology	/frontal:manage-ontology	Schema definition, validation, migrations, AI generation

Rules

Rule	Scope
frontal-api-conventions	Auth patterns, error handling, base URLs
frontal-sdk-usage	Package selection, builder patterns, env config
agent-design-patterns	Confidence thresholds, memory, deployment

Agents

Agent	Purpose
frontal-architect	Designs agent workflows, selects integrations, plans pipelines
frontal-debugger	Diagnoses failed invocations and pipeline errors
frontal-reviewer	Reviews configs for correctness, security, best practices

Commands

Command	Purpose
deploy-agent	Deploy an agent to a target environment
test-agent	Run a test invocation and validate the response
check-status	Health check on platform connectivity

---

SDK Reference

This plugin uses the official Frontal TypeScript SDK:

Package	Description
@frontal-labs/core	HTTP client, auth, retries, pagination
@frontal-labs/ai	AI inference, streaming, embeddings
@frontal-labs/agents	Agent lifecycle and execution
@frontal-labs/workflows	Workflow orchestration
@frontal-labs/pipelines	Data pipeline management
@frontal-labs/graph	Graph/ontology queries
@frontal-labs/blob	Object storage
@frontal-labs/functions	Serverless compute

---

Environment Variables

Variable	Required	Default
FRONTAL_API_KEY	Yes	—
FRONTAL_API_URL	No	https://api.frontal.dev/v1
FRONTAL_AI_API_URL	No	https://ai.frontal.dev
FRONTAL_AGENTS_API_URL	No	https://api.frontal.dev/v1
FRONTAL_WORKFLOWS_API_URL	No	https://api.frontal.dev/v1
FRONTAL_PIPELINES_API_URL	No	https://api.frontal.dev/v1
FRONTAL_GRAPH_API_URL	No	https://api.frontal.dev/v1
FRONTAL_BLOB_API_URL	No	https://api.frontal.dev/v1
FRONTAL_FUNCTIONS_API_URL	No	https://api.frontal.dev/v1
FRONTAL_ONTOLOGY_API_URL	No	https://api.frontal.dev/v1

---

Validation

Run the template validator to check plugin structure:

node scripts/validate-template.mjs

---

License

Apache-2.0 — see LICENSE.md