π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
RuFlo Research
Goal-Oriented Action Planning UI for autonomous AI research workflows. Part of the RuFlo platform. Live: goal.ruv.io Β· Agents dashboard: goal.ruv.io/agents
Turn plain-English research goals into executable agent plans. RuFlo Research applies classic Goal-Oriented Action Planning (GOAP) β A* search through a state space of actions with preconditions and effects β to autonomous AI research, then dispatches the work to live agents you can inspect in real time.
Highlights
| π― Plain-English goals | Describe an outcome β RuFlo extracts success criteria, constraints, and implicit preconditions |
| π§ GOAP A* planner | Shortest-path search through actions with preconditions/effects; replans on the fly when state changes |
| π€ Live agent dashboard | /agents shows every spawned agent β role, current step, status, trajectories |
| π³ Visual plan tree | Goals render as collapsible action trees with progress, blocked branches, rollbacks |
| β»οΈ Adaptive replanning | When an action fails, A* re-runs from the current state instead of restarting |
| π Embeddable widget | Drop the research UI into any site via <script src="widget.js"> |
Quick Start
# from /v3/goal_ui
npm install
npm run dev # main app on http://localhost:8080
For the embeddable widget:
npm run build:widget # produces dist/widget.js + dist/widget.css
npm run widget:dev # build widget + start dev server
Project Structure
v3/goal_ui/
βββ src/
β βββ components/ # React components (GoalInput, AgentStep, ResearchReportModal, β¦)
β βββ pages/ # Index, Agents, Demo, NotFound
β βββ lib/goapPlanner.ts # GOAP A* implementation
β βββ integrations/supabase/ # Supabase client + types
β βββ widget.tsx # Embeddable widget entry
βββ supabase/functions/ # Edge functions (research-step, generate-research-goal, β¦)
βββ public/ # Static assets, widget-embed.html demo
βββ docs/ # DEPLOYMENT.md, WIDGET-INTEGRATION.md, WIDGET_SETUP.md
βββ netlify.toml # Hosting config
Embedding the Widget
<div id="ruflo-research-widget-container"></div>
<script>
window.RufloResearchWidgetConfig = {
primaryColor: "#8b5cf6",
accentColor: "#10b981",
};
</script>
<script src="https://goal.ruv.io/widget.js"></script>
<link rel="stylesheet" href="https://goal.ruv.io/widget.css" />
The widget exposes a global window.RufloResearchWidget with init(containerId) and version for programmatic control. See docs/WIDGET-INTEGRATION.md for the full integration guide.
Tech Stack
React 18 Β· TypeScript 5 Β· Vite 5 Β· Tailwind 3 Β· shadcn/ui Β· Radix UI Β· React Query Β· React Router Β· Supabase Edge Functions Β· GOAP A* planner
Deployment
Hosted on Netlify (netlify.toml) at goal.ruv.io. See docs/DEPLOYMENT.md for self-hosting instructions and edge-function deploy steps.
Environment
Copy example.env β .env and set the Supabase publishable variables (all VITE_* prefixed and safe to ship to the browser):
VITE_SUPABASE_URL=...
VITE_SUPABASE_PROJECT_ID=...
VITE_SUPABASE_PUBLISHABLE_KEY=...
License
MIT β same as the parent RuFlo project.