Refly

Overview#

Refly is the first open-source AI agent skills builder that allows users to describe business logic via natural language (Vibe Workflow), converting it into production-ready agent skills within 3 minutes. The platform features an intervenable stateful runtime that supports pausing, auditing, and redirection to ensure deterministic execution and minimize hallucinations.

Core Features#

Vibe Workflow Builder

• Describe business logic via natural language, AI-driven DSL compiles into high-performance skills
• Rapid conversion from static SOPs to production-ready agent skills

Intervenable Runtime

• Stateful runtime with support for pausing, auditing, and redirecting agent logic
• Deterministic guarantees enforcing strict business rules

Unified Agent Stack

• Unified MCP integration, tools, models, and reusable skills
• Export as APIs, Webhooks, or native tools
• 3,000+ native tool integrations (Stripe, Slack, Salesforce, GitHub, etc.)
• Full MCP (Model Context Protocol) server compatibility

Skills Registry

• Centralized skill management, versioning, and sharing
• Team workspace collaboration with native version control and audit logs

Use Cases#

1. API Integration - Trigger workflows via REST API for application integration
2. Webhook Integration - Feishu/Lark message triggers for enterprise chatbots
3. Claude Code Skills - Publish Refly workflows as Claude Code skills
4. Clawdbot Building - Build custom AI assistants

Installation#

Requirements: Docker >= 20.10.0, Node.js >= 20.19.0 (LTS), pnpm >= 10

# Clone repository
git clone git@github.com:<github_username>/refly.git

# Start middleware
docker compose -f deploy/docker/docker-compose.middleware.yml -p refly up -d

# Install dependencies
corepack enable
pnpm install

# Setup environment
pnpm copy-env:develop

# Build and start
pnpm build
pnpm dev

Access: Development http://localhost:5173, Production http://localhost:5700

API & CLI#

API Example

# Execute workflow
curl -X POST https://your-refly-instance.com/api/v1/workflows/{WORKFLOW_ID}/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"product_url": "https://example.com/product"}}'

Refly CLI

npm install -g @powerformer/refly-cli
refly skill install <skill-id>
refly skill publish <skill-id>

Architecture#

pnpm monorepo structure:

• Frontend: React + TypeScript + Tailwind CSS
• Backend: NestJS + Prisma ORM
• Packages: CLI, skill templates, agent tools, provider abstractions

Key modules: skill (skill management), workflow (execution), action (agent actions), mcp-server (MCP protocol), rag (RAG pipeline), knowledge (knowledge base), schedule (task scheduling)

Integrations#

Supports Claude Code, Cursor, Codex, Feishu/Lark environments. Native integration with 3,000+ tools including Stripe, Slack, GitHub, Salesforce.

License#

Apache License 2.0 with additional commercial restrictions. Contact support@refly.ai for enterprise licensing.