explaingit

refly-ai/refly

7,296TypeScriptAudience · pm founderComplexity · 4/5LicenseSetup · moderate

TLDR

An open-source platform for building reusable AI agent workflows visually, then deploying them as API endpoints, webhooks, or scheduled jobs that connect to 3,000+ external tools like Slack, Stripe, and GitHub.

Mindmap

mindmap
  root((repo))
    What it does
      Visual workflow builder
      Reusable agent skills
      Deploy anywhere
    Deployment Targets
      API endpoint
      Webhook chat
      Scheduled job
      AI coding tools
    Integrations
      3000 plus tools
      Slack Stripe GitHub
      MCP protocol
    Self-Hosting
      Docker setup
      Version control
      Audit logs
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Define a customer-support AI workflow once in the visual builder and deploy it as an API endpoint that a no-code app like Lovable can call.

USE CASE 2

Create a scheduled agent job that checks GitHub issues every morning and posts a summary to a Slack channel automatically.

USE CASE 3

Build an intervenable AI workflow for a team where a manager can pause and redirect the agent mid-run before it takes a critical action.

Tech stack

TypeScriptDockerMCPREST API

Getting it running

Difficulty · moderate Time to first run · 1h+

Self-hosting requires Docker, hosted version at refly.ai is faster to start but subject to the custom Refly AI License terms.

Released under the Refly AI License, a custom license, not a standard open-source license, check the full license text before using commercially.

In plain English

Refly is an open-source platform for building what the project calls agent skills: structured, reusable pieces of workflow logic that AI agents can execute reliably. The core argument behind it is that most AI automation breaks down in practice because it relies on one-off prompts and fragile scripts. Refly is designed to let you define your business logic once in a visual interface and then deploy it anywhere that needs it. The workflow starts in Refly's visual builder, where you describe what you want in plain language and the platform compiles it into a structured, version-controlled skill. Once built, a skill can be exported as an API endpoint (so an app builder like Lovable can call it), as a webhook for chat platforms like Slack or Lark, as a native tool for AI coding assistants like Claude Code or Cursor, or as a scheduled background job. The README describes this as skills being infrastructure rather than prompts. Refly also has a concept of an intervenable runtime, meaning you can pause a running agent workflow mid-execution to audit what it is doing and redirect it if needed. This is aimed at enterprise use cases where an agent making an incorrect decision undetected could cause real problems. Version control and audit logs are built into the workspace for team use. The platform connects to over 3,000 external tools out of the box including Stripe, Slack, Salesforce, and GitHub. It also supports the Model Context Protocol, which is a standard for connecting AI models to external data and tools. You can self-host Refly on your own server using Docker, or use the hosted version at refly.ai. A public skill registry at a companion repository allows the community to share, fork, and publish skills. The project is written in TypeScript and released under the Refly AI License, which is a custom license rather than a standard open-source one. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to self-host Refly using Docker. Walk me through the docker-compose setup, required environment variables, and how to access the visual workflow builder after startup.
Prompt 2
In Refly, how do I create an agent skill that takes a customer email as input, looks up their Stripe subscription status, and replies with their plan details via Slack?
Prompt 3
I want to connect Refly to Claude Code as a native tool. What MCP configuration do I need on the Refly side, and how do I register the skill in Claude Code's settings?
Prompt 4
How does Refly's intervenable runtime work? Show me how to set a pause checkpoint in a workflow so a human can review the agent output before it sends a message to Salesforce.
Open on GitHub → Explain another repo

← refly-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.