rerun README

The project's README from github.com/rerun-build/rerun. As one markdown file: README.md.

Rerun: the Foreman presenting a team of coworkers on the board

Rerun

Hire AI coworkers for your team.
They use your tools, work on a schedule, and check with you before anything that matters.

License: AGPL-3.0 CI Release Stars Discord

Host it yourself »

Docs · Rerun Cloud · Discord · Contributing


Your coworkers work in:

Gmail Google Calendar Google Drive Google Sheets Slack Notion
HubSpot Airtable Stripe Shopify GitHub Linear
Jira Figma Webflow X YouTube Instagram

and 200+ more in the catalog, any MCP server, 2,000+ apps through Composio

On the models you pick:

Anthropic OpenAI Gemini OpenRouter

an API key, or the Claude or ChatGPT subscription you already pay for


👋 Meet your new team

You tell Rerun what you need done, in plain words. The Foreman interviews you, plans a team and builds it. Each coworker gets a job, its own memory, its own skills and its own computer. You see them all on one board, you talk to any of them like to a colleague, and they ask before they send, pay or delete anything.

Eight coworkers in three Boxes on the board, the Sales Rep reporting the companies it found

A few coworkers people hire on day one, each a ready-made template:

Executive Assistant
Executive Assistant
Sorts your inbox, clears your calendar, briefs you every morning 		Data Analyst
Data Analyst
Answers your questions from your data, with charts and a weekly KPI report 		Reputation Manager
Reputation Manager
Watches your reviews and your competitors, drafts every reply
Sales Development Rep
Sales Development Rep
Finds prospects who fit and writes each one a first email 		Social Media Manager
Social Media Manager
Writes a week of posts for each network, publishes when you say go 		Collections Specialist
Collections Specialist
Chases every late invoice, without the awkward emails

✨ Features

The Foreman, taking requests by voice, hiring a coworker and running the team on autopilot

🧑‍✈️ The Foreman runs your team. Say what you need, out loud if you like. It spots what needs doing, hires the coworker for it, and answers your coworkers by your rules while you are away.

A coworker sending an email from its own browser
🖥️ Their own computer
A browser and a screen you can watch, and take over at any time 		A coworker waiting for a teammate to approve a payment
✋ You stay in charge
They stop and ask before they send, pay or delete anything
Coworkers running at night while the team is away
⏰ Work while you sleep
Schedules and webhook triggers: the 7am run happens without you 		Three coworkers handing a job down the line
🤝 They work together
One finds the leads, the next writes to them, a third files the result

And everything else a colleague needs:

🚀 Quick start

Let an AI install it for you:

Install with Claude Install with ChatGPT

Or paste this into Claude Code, Codex or Cursor, which run the commands for you:

Install Rerun, the open source AI coworkers app, for me. Follow the guide written for AI assistants: https://raw.githubusercontent.com/rerun-build/rerun/main/INSTALL.md

By hand, you need Docker, Node.js 22, and a Supabase project (a free one on supabase.com works).

git clone https://github.com/rerun-build/rerun.git && cd rerun
cp .env.example .env          # fill the Supabase URL and keys, and an OpenRouter key
npx supabase link --project-ref <your-project-ref> && npx supabase db push --include-seed
node scripts/self-host-check.mjs
docker compose up -d --build  # then open http://localhost:3000

That's it, say hi to the Foreman. 🎉

The self-hosting guide walks through every step, including Supabase on your own machine, adding servers, HTTPS and updates.

☁️ Open source or Rerun Cloud?

Same product, same code. Rerun Cloud is this Rerun, hosted, plus what only a hosted service can offer.

🛠️ Open source ☁️ Rerun Cloud
Coworkers, chat, memory, skills, schedules ✅ ✅
Services catalog, MCP, Composio ✅ ✅
Template library Your own templates ✅
A computer for each workspace You host it, one command attaches it Ready in 30 seconds
AI models Your keys or subscriptions Included credit, or your keys
Premium features (LinkedIn, WhatsApp, paid data, emails) ✅
Updates Each release Continuous
Support Community ✅
Price Free forever See plans

🧩 How it fits together

flowchart LR
    you(["🧑 You"]) --> app["<b>App</b><br/>Next.js · apps/ui"]
    app <--> db[("<b>Supabase</b><br/>Postgres, auth,<br/>storage, realtime")]
    app <--> engine["<b>Engine</b> · apps/engine<br/>one per workspace"]
    engine --> coworkers["🤖 Coworkers<br/>files, browser, screen"]
    engine <--> tools["🔌 Your tools<br/>MCP, APIs"]
    engine <--> models["🧠 Your models"]

Built with Next.js, React, Tailwind, Supabase, the Vercel AI SDK, Hono, libSQL, Patchright and Docker, in a pnpm monorepo.

🤝 Contributing

Bug reports, fixes and docs are welcome. Read CONTRIBUTING.md first: it explains how to run Rerun from source and how pull requests flow back into Rerun Cloud.

Self-hosted installs get community support on GitHub: an issue without logs or steps to reproduce is closed with a link to the guide. Questions and show-and-tell go to Discord.

If Rerun saves you a few hours, a ⭐ helps a lot.

Star history

📜 License

AGPL-3.0. You can run, modify and host Rerun freely; if you host it for others, you publish your changes under the same license. The name and logo are not covered: see TRADEMARK.md.

rerun (rerun-build/rerun)

Searching Database…

576 ·GitHub
Rerun
What is this?Rerun is a self-hostable app for hiring AI coworkers that run your recurring work. They use your tools, work on a schedule and check with you before anything important happens.
How is it different from a single chatbot?You describe the work and the Foreman builds a team of coworkers. Each one gets its own job, memory, skills and computer, and you see them all on one board and chat with them like colleagues.
How do I get it running?The easiest route is to have Claude Code, Codex or Cursor run the install for you. By hand, follow the self-hosting guide, which covers Supabase, adding servers, HTTPS and updates.
Do I need Docker or Supabase first?Yes. A manual install needs Docker, Node.js 22 and a Supabase project, and a free Supabase project from supabase.com is enough to start.
What does the open-source version leave out?Premium features such as LinkedIn, WhatsApp, paid data and emails are only in Rerun Cloud, along with hosted computers and continuous updates. Self-hosted installs get community support on GitHub and Discord.
What is the Foreman?The Foreman is the lead agent that runs your team. You say what you need, it spots the work, hires the right coworker and answers your coworkers by your rules while you are away.
Can coworkers hand work to each other?Yes. One coworker finds the leads, the next writes to them and a third files the results, so they work through the same task chain.
How do I connect my other tools?It includes 200+ ready integrations and works with any MCP server, plus Composio for 2,000+ apps.
What are similar projects?mike, itsaplan, trigger.dev, LoomFlow, evenfire, onlook, asobeast, sim
Which topics is it in?supabase, scheduler, webhooks, agplv3, monorepo, browser-automation, workflow-automation, nextjs, web-app, productivity, react, mcp
Creator
rerun-build
Size
19.5 MB
Stars
576
Updated
CommitNov 03Releasev0.5.0Nov 03
Age
5d
Commits · 90 Days