ai-employees README

The project's README from github.com/markfulton/ai-employees. As one markdown file: README.md.

AI Employees

Eight open source AI Employees. Each one runs a whole business role.

60 scheduled routines. Your own machine. The AI agent you already use.

The eight AI Employees  •  Agent Ops Club  •  Live sessions  •  Software library  •  FAQ

Stars MIT license npm ai-employees Claude Code and ten other agents Windows, macOS and Linux

Get my free install prompt in the Agent Ops Club Join the Agent Ops Club free Agent Ops Club live sessions Visit the Agent Ops Club

Runs on the agent you use: Claude Code, OpenClaw, Hermes, OpenCode, Grok Bot, Codex, Antigravity, Pi, Cline, Qwen Code and DeepSeek

⭐ Found something useful? Star the repo. It takes a second and helps the next person find it.

AI Employees

An AI Employee is a folder of scheduled routines that covers one business role. It runs on your own machine, on the AI agent you already use, and briefs you every morning. They drive your browser and your PC the way you do, and every run makes the next one better. Eight roles, every routine and schedule in this repo, nothing held back.

Created by Mark Fulton of Reinventing.AI, founder of Vibe Coding is Life (340,000+ members). Running my own business every weekday since August 27, 2026.

The eight AI Employees

Employee What it owns Routines

GTM Engineer		 Your launch: positioning, the launch board, outbound drafts, directory and press forms, the weekly scoreboard 8

SEO/AEO Employee		 Keyword research, one article a weekday, publishing, indexing, rank review and your visibility in AI answers 8

Web Dev Employee		 Site health, error triage, small changes on a branch, dependency review 8

Social Media Employee		 Posts drafted in your voice for each platform, a veto window, replies drafted for you 7

Ad Manager Employee		 Account reads, creative sets, build sheets and the weekly change list. Money moves only when you approve 7

Sales Employee		 Prospect sweeps, first touches into your own drafts, follow ups that never go quiet 7

Customer Satisfaction Employee		 Inbox sweep, replies drafted hardest first, churn flags with evidence 8

Chief of Staff		 Reads every other employee's run log, names what quietly stopped, brings you three moves 7

Sixty routines. Every kit, with its full schedule and a sample of its output, is in employees/.

Install in two steps

1. Download a kit and extract it to your PC. Click Code, Download ZIP above, or run npx ai-employees hire gtm-engineer --to <folder>. Any folder not inside OneDrive, Dropbox, Google Drive or iCloud.

2. Open your agent in that folder and say "Install the GTM Engineer from this folder." It researches your business from your website, builds your dashboard, schedules its own routines, and stops once to show you its first drafts.

You need an AI agent you are logged in to (Claude Code is what I use) and a browser signed in to the accounts it should read. Prerequisites. Full install guide.

On Claude Code, as a plugin

This repository is also a Claude Code plugin with one skill, hire, and all eight kits bundled. In any Claude Code session:

/plugin marketplace add markfulton/ai-employees
/plugin install ai-employees@ai-employees

Then say "hire the GTM Engineer into D:\AgentOps\gtm-engineer", or run /ai-employees:hire. The skill checks the folder is outside cloud sync, copies the kit from the plugin with no download, runs the self tests, and tells you the one line to say in a fresh session in that folder. It registers nothing and sends nothing. The plugin page has the same steps with a walkthrough.

Not on Claude Code? The same two steps work on OpenClaw, Hermes, OpenCode, Grok Bot, Codex, Antigravity, Pi, Cline, Qwen Code and DeepSeek. docs/HARNESSES.md has the command for each.

Get your install prompt and a guided first hire, free

Hiring one or all eight, pick your roles in the Agent Ops Club and copy one prompt your agent runs from start to finish. The Hire Your First AI Employee walkthrough takes you through it step by step.

Get my install prompt and walkthrough, free in the Agent Ops Club

Free account, no card.

What sets these AI Employees apart

The long version.

What a morning looks like

The brief the GTM Engineer leaves, from a fictional business, Northwind Roofing. Yours has your cards in it.

# 2026-03-05

## Today
- C-007 | Stage the storm season email for segment-1 | queue/2026-03-05-email.md
- C-011 | Fill the local trades directory listing and leave the tab open | queue/2026-03-05-form.md
- C-012 | Verify the quote request conversion event fires on the thank you page | paid/conversion-quote-request.md

## Waiting on you
- queue/2026-03-05-email.md: three drafts, none ticked
- C-009 | Submit the supplier co-marketing listing | filled in its tab, the submit is yours

## Blocked
- gtm-signal-sweep, open since 2026-02-26: the review platform asked for a sign in, nothing entered

The full brief, with the run log and the ledgers beside it.

How an AI Employee runs

A folder of plain text files you can open and change. Nothing runs anywhere else.

gtm-engineer/
  INSTALL-PROMPT.md        what your agent reads to set itself up, once
  ROLE.md                  who this employee is and how it thinks
  SCHEDULE.md              when each routine runs
  RELEASES.md              yours: the channels you have released, shipped empty
  routines/<id>/SKILL.md   one folder per routine

Each routine runs at its time, inside a window. If your machine was asleep and the job fires late or twice, it sees the work is done and does nothing.

Two guardrails. Shipped, every send, post, submit, publish and spend is held for your click, and RELEASES.md is where you hand a channel over. No AI Employee ever creates an account, enters a password, completes a captcha or accepts terms.

How employees work. The guardrails, routine by routine.

What AI Employees cost to run

On a Claude Pro or Max plan, nothing beyond the plan. They spend a share of your plan's usage limits, not dollars. Measured on my own Max seat, the GTM Engineer's scheduled runs were about 6 percent of everything the machine sent to Claude. docs/COST.md has the method, the per routine table and the API key reference.

Go further

The eight are free for good. The Agent Ops Masterclass, the premium software library with a resale license, the live sessions and, from October, premium AI Employees live in the Agent Ops Club. A free club account gets you the session calendar, the walkthrough lesson with the launch replay, the preview lessons and AI Employee updates.

FAQ

Does it send anything? By default, no. It drafts, fills and stages, and you press the button. Windows, Mac or Linux? All three. Can I run just one? Yes, each is a self contained folder. Can I sell installs to clients? Yes, it is MIT; just do not call yours by the club's name. The rest is in docs/FAQ.md.

Contributing

Routine requests, new employee proposals, harness reports and corrections from real runs are all welcome. Post what an employee did for your business in Discussions under Show and tell. CONTRIBUTING.md has the rules.

License

MIT. Copyright (c) 2026 Mark Fulton. LICENSE. Names and logos are not licensed, and forks get their own name: TRADEMARKS.md.

Built by Mark Fulton with Claude Code. Every contributor is in CREDITS.md. Report a way to make an employee send or spend through SECURITY.md, not a public issue.

ai-employees (markfulton/ai-employees)

Searching Database…

630 ·GitHub
Ai-employees
What is this?Eight open source AI Employees for small business: each is a self-contained kit that runs one business role — 60 scheduled routines in total — on your own machine, driven by the AI coding agent you already use, like Claude Code.
Is this an app I install, or something else?Not an app — each employee is a folder of plain text files you can open and change: the routines and schedules your AI agent executes. Nothing runs anywhere else, and you own every file.
How do I get one running?Two steps: download a kit into a folder outside cloud sync (npx ai-employees hire gtm-engineer --to . or Code > Download ZIP), then open your agent there and say 'Install the GTM Engineer from this folder.' It researches your business, builds a dashboard and schedules its own routines.
What do I need before installing?An AI agent you are logged in to — Claude Code is what the author uses — and a browser signed in to the accounts the employee should read.
Will it post, send and spend money on its own?No — everything is drafted, filled and staged, and the last click is yours until you hand a channel over in RELEASES.md. Employees never create accounts, enter passwords, complete captchas or accept terms.
Does it work on Windows, Mac and Linux?All three, since everything runs locally on your own machine next to your AI agent and browser.
What does a morning with an AI Employee look like?Each employee leaves you one brief every morning, with its run log and ledgers beside it, and pushes to your phone only when you are the blocker.
How do updates work — will they overwrite my edits?No: npx ai-employees upgrade leaves every file you edited alone, and a newer kit is announced once a month in plain words in the morning brief.
Why did the author build these instead of a SaaS product?Mark Fulton of Reinventing.AI runs his own business with them every weekday since August 27, 2026. The kits are plain files on your machine, so you own everything and nothing runs anywhere else.
What are similar projects?internet-court-skill, marketingskills, superpowers-zh, token-monitor, ai-manager, brag, linkedin-agent-skill, dbskill
Which topics is it in?customer-support, business, seo, claude-skill, antigravity, hermes-agent, marketing, claude-code-plugin, openclaw, opencode, browser-automation, local-first
Creator
markfulton
Size
10.8 MB
Stars
630
Updated
CommitOct 14
Age
1mo
Commits · 90 Days