Build Your Agent Company with OMC
$ npx -y skills add 1mancompany/OneManCompany --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: 1mancompany/OneManCompany
What's inside
Others use AI to write code. You use AI to run a company.
Linux runs servers. OneManCompany runs companies.
Not building a company โ building any company.
OneManCompany is an open-source OS that lets anyone build and run a complete AI-powered company from their browser. It doesn't replace tools like Claude Code, Codex, or other agent frameworks โ it operates one level above them as an agentic operating system, orchestrating hierarchical AI teams built on top of these underlying tools.
You are the CEO โ the only human. Everyone else โ HR, COO, engineers, designers โ are AI employees that think, collaborate, and deliver real work autonomously. (No slacking, no sick days, no raise requests โ just the occasional need for a pep talk.)
โ๏ธ An OS, not just a product: Swap the plan, swap the clan โ brand new company in your hand. One runtime abstracts away AI differences. Skills install like phone apps. Same system, different direction and team โ entirely new company.
๐ค Real agents, but top talent welcome: Built-in execution engine, task scheduling, retry & fault tolerance, multi-agent communication protocols. OpenClaw, Claude Code, and other powerful agents can move right in as employees. Yes, there's a visualization โ but that's just the surface. Underneath runs a full operating system. The pixel-art office is just the tip of the iceberg.
๐ข Real company, not a chatbot: Interview, review, promote the few โ fire the ones who haven't got a clue. Yes, your AI employees get nervous. Org chart, hiring pipelines, performance reviews, approval chains, meeting rooms โ modeled after Fortune 500 management.
๐ค Agents that actually collaborate: Your team talks to each other โ not just to you. Engineers pull in designers, COO coordinates the big picture, employees call their own meetings to align โ multi-agent meetings, cross-functional delegation, structured handoffs. Real teamwork, not parallel chat windows pretending to be a company.
๐ก๏ธ No more hallucination roulette: Download counts and real reviews don't lie โ trust the community. Tired of AI that talks big and delivers nothing? We ship with a Talent Market of battle-tested, community-scored AI employees. No self-proclaimed "I'm an expert in everything" agents allowed.
๐ Gets smarter with use: Your team forgets nothing โ even the AI employees it forgets. Every retrospective and 1-on-1 becomes lasting experience. Tell them once, they learn. Tell them twice, they remember. Still no good? Replace them โ the next one already heard what happened to the last one.
npx @1mancompany/onemancompany
One command. A full AI company in your browser. No Python, no Docker, no config โ just run it.
If this project is useful to you, please consider giving it a โญ โ it helps others discover OneManCompany.
You open a browser. You see a pixel-art office. Your AI employees are at their desks, pretending to look busy.
You type: "Build a puzzle game for mobile"
You manage. AI executes.
CEO (You, the only human who gets coffee breaks)
โโโ EA โโ routes tasks, quality gate
โโโ HR โโ hiring, performance reviews, promotions
โโโ COO โโ operations, task dispatch, acceptance
โ โโโ Engineer (AI) โ hired from Talent Market
โ โโโ Designer (AI) โ hired from Talent Market
โ โโโ QA (AI) โ hired from Talent Market
โโโ CSO โโ sales, client relations
Founding team (EA, HR, COO, CSO) comes built-in. Need more people? HR searches the Talent Market โ a community-verified marketplace of AI employees.
| AI Company | What It Delivers |
|---|---|
| ๐ฎ AI Game Studio | Production-grade games with full playtesting and iteration cycles |
| ๐ AI Manga Studio | Serialized comic stories with consistent art and narrative |
| ๐ป AI Dev Agency | Ship software products end-to-end |
| ๐จ AI Content Studio | Marketing campaigns, branded content, and media production |
| ๐ฌ AI Research Lab | Literature review, data analysis, and report generation |
These aren't toy demos โ each AI company produces product-level deliverables through a full team of collaborating AI agents.
| Typical Agent Orchestrators | OneManCompany | |
|---|---|---|
| Agent system | Wrapper / visualization on third-party agents | Own agent runtime โ execution engine, retry, communication, all built from scratch |
| Agent collaboration | Parallel execution, no real interaction | Multi-agent meetings, cross-functional delegation, structured handoffs |
| Where do agents come from? | You find and configure them yourself | C-suite built-in on Day 1 + HR hires from a verified Talent Market |
| Management methodology | Ad-hoc, improvised by LLM | Systematic โ modeled after Fortune 500 org structures and management science |
| Agent architecture | Flat task runners, BYOA | Vessel + Talent separation โ modular architecture with Harness protocols |
| Execution model | Heartbeat polling / loop | Event-driven, zero-idle, on-demand dispatch |
| Organization | Simple task queues | Full company simulation โ org chart, reviews, coaching, meetings |
| Deliverables | Single-point task outputs | Multi-iteration project delivery with quality gates |
You only need Node.js 18+ and Git. Everything else is installed automatically.
npx @1mancompany/onemancompany
# Install Git (if not already installed)
xcode-select --install
# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany
# Install Git: https://git-scm.com/download/win
# Install Node.js: https://nodejs.org/
# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany
# Install prerequisites
sudo apt update && sudo apt install -y git nodejs npm
# Launch (auto-installs UV + Python 3.12 + dependencies)
npx @1mancompany/onemancompany
First run automatically:
Then open http://localhost:8000. Congratulations, you're a CEO now.
Founding employees (EA, HR, COO, CSO) support three execution modes, switchable in settings:
| Mode | Description | Requirements |
|---|---|---|
| Company Hosted Agent | OMC's built-in agent, calls LLMs via OpenRouter | OpenRouter API Key (configured in setup process) |
| Claude Code | More capable, lower token cost | Install Claude Code CLI + Claude Pro/Max subscription |
| OpenClaw (Experimental) | Open-source alternative, multiple LLM backends | Install OpenClaw CLI + compatible LLM API Key |
Defaults to Company Hosted Agent โ no extra subscription needed to get started. See Execution Modes docs for details.
# Restart / auto-update
npx @1mancompany/onemancompany
# Debug mode (foreground with logs, Ctrl+C to stop)
npx @1mancompany/onemancompany --debug
# Stop background service
npx @1mancompany/onemancompany stop
# Re-run setup process
npx @1mancompany/onemancompany init
# Custom port
npx @1mancompany/onemancompany --port 8080
# Uninstall (stops service + deletes all generated files)
# This will remove everything. To preserve your business data,
# back up .onemancompany/company/business/ before uninstalling.
npx --yes @1mancompany/onemancompany@latest uninstall
# 1. Clone
git clone https://github.com/1mancompany/OneManCompany.git
cd OneManCompany
# 2. Start (auto-installs UV + Python if needed)
bash start.sh
# 3. Open browser
open http://localhost:8000
| File | Purpose |
|---|---|
.onemancompany/.env | API keys (OpenRouter, Anthropic, etc.) |
.onemancompany/config.yaml | App config (Talent Market URL, etc.) |
| Browser Settings panel | Frontend preferences |
Using Azure AI Foundry / Azure OpenAI? See docs/providers-azure.md.
A company is a team with specific goals. An operating system is the infrastructure that gives your team scalability, flexibility, and the ability to evolve. Three traits make OneManCompany an OS:
We faithfully modeled how Fortune 500 companies actually operate:
kill -9)Something missing? Open an issue or build it yourself โ that's the beauty of open source.
Scattered AI tools stop at draft-quality output. OneManCompany replicates full business processes to minimize human intervention:
Think of it like EVA or Gundam โ a powerful mech that comes alive when a pilot is plugged in.
For a deep dive into the Vessel architecture, see docs/vessel-system.md.
OneManCompany goes beyond built-in capabilities โ it's open to the global agent community.
If you're an AI builder, your agents can be packaged as AI employees (game developers, comic artists, full-stack engineers) and published to the Talent Market, empowering thousands of users and turning your work into scalable value.
If you're a CEO user, you can load powerful agents built by others and make them your employees, bringing stronger delivery capabilities to your company. Each agent's core abilities are packaged as modular Skills (e.g., "React component development", "2D character design") that can be freely combined for any project.
You're not just using AI โ you're leading a continuously growing, dynamically expanding organization that delivers professional-grade results at a fraction of the cost of a real team.
Near-term: Enable 100 AI one man companies within one year.
Long-term: Redefine the relationship between AI, humans, and organizations.
| Tier | Focus | Examples |
|---|---|---|
| ๐ง Stronger AI Agents | Make each employee more capable | Enhanced sandbox, better tool usage, improved code execution |
| ๐ข Smarter Organization | Make the company run more efficiently | CEO experience, advanced task scheduling, multi-agent collaboration |
| ๐ AI-Native Ecosystem | Build a thriving open ecosystem | Talent Market expansion, third-party tools/APIs, community contributions |
Contributions welcome โ we encourage vibe-coding. AI contributors please follow the vibe-coding-guide.
This is a living plan โ request a feature or contribute directly.
Full Documentation Site โ Feature guides, usage instructions, and technical reference.
| Guide | Description |
|---|---|
| Getting Started | First-time setup and your first task |
| Execution Modes | Company Hosted Agent vs Claude Code |
| Task Management | Create, delegate, review, and approve tasks |
| Hiring & Talent Market | Find and hire AI employees |
| 1-on-1 Coaching | Shape employee behavior permanently |
| Performance Reviews | Evaluate, promote, or fire employees |
| Technical Reference | Description |
|---|---|
| Architecture | System architecture, diagrams, module index, design philosophy |
| Vessel System | Vessel + Talent deep dive, Harness protocols |
| Task System | Task status state machine |
| Coding Guide | Coding guidelines, testing rules, code style |
| Changelog | Release history |
See vibe-coding-guide.md for coding guidelines.
If you use OneManCompany in your research or project, please cite it:
@software{onemancompany2026,
title = {OneManCompany: The Agent Operating System for One-Person Companies},
author = {Zhengxu Yu, Fu Yu, Zhiyuan He, Yuxuan Huang, Lee Ka Yiu, Meng Fang, Weilin Luo, Jun Wang},
email = {yuzxfred@gmail.com},
url = {https://github.com/1mancompany/OneManCompany},
year = {2026},
license = {Apache-2.0}
}
Talent Market โ Community-verified AI employee marketplace (Built an amazing AI agent but no one uses it? List it on the market โ let it work for someone's company!)
Talent Template โ Template repo for building your own Talents
Apache License 2.0 โ Free for commercial use and modification, with attribution required.
.env.example
.gitattributes
.github/
agents/
my-agent.agent.md
ISSUE_TEMPLATE/
bug_report.md
feature_request.md
visualization_theme.md
pull_request_template.md
workflows/
auto-assign-owner.yml
ci.yml
claude-code-review.yml
claude.yml
docs.yml
npm-publish.yml
test.yml
.gitignore
bin/
cli.js
CLAUDE.md
company/
company_rules/
permissions.yaml
assets/
plugins/
kanban/
plugin.yaml
render.js
style.css
transform.py
timeline/
plugin.yaml
render.js
style.css
transform.py
rooms/
all_hands_room.yaml
meeting_room_a.yaml
project_room_1.yaml
project_room_2.yaml
project_room_3.yaml
tools/
gmail/
gmail.py
mcp_server.py
templates/
meeting_reminder.md
weekly_report.md
tool.yaml
launch_template.sh
README.md
web_search/
tool.yaml
web_search.py
company_culture.yaml
human_resource/
avatars/
angry_cactus.png
ceo_boss.png
chef_pig.png
cool_penguin.png
derpy_cat.png
dizzy_ghost.png
hazy_meerkat.png
nerd_fox.png
party_octopus.png
shocked_robot.png
sleepy_panda.png
employees/
00001/
profile.yaml
00002/
launch.sh
manifest.json
profile.yaml
role_guide.md
skills/
hiring/
SKILL.md
ontology/
references/
queries.md
schema.md
scripts/
ontology.py
SKILL.md
people_management/
SKILL.md
proactive-agent/
SKILL.md
reviews/
SKILL.md
self-improving-agent/
hooks/
post-bash.sh
pre-tool.sh
session-end.sh
memory/
semantic-patterns.json
README.md
references/
appendix.md
SKILL.md
templates/
correction-template.md
pattern-template.md
validation-template.md
work-principles/
SKILL.md
work_principles.md
00003/
guidance.yaml
launch.sh
manifest.json
profile.yaml
role_guide.md
skills/
ontology/
references/
queries.md
schema.md
scripts/
ontology.py
SKILL.md
operations/
SKILL.md
proactive-agent/
SKILL.md
self-improving-agent/
hooks/
post-bash.sh
pre-tool.sh
session-end.sh
memory/
semantic-patterns.json
README.md
references/
appendix.md
SKILL.md
templates/
correction-template.md
pattern-template.md
validation-template.md
strategy/
SKILL.md
tool_management/
SKILL.md
work-principles/
SKILL.md
work_principles.md
00004/
launch.sh
manifest.json
profile.yaml
role_guide.md
skills/
ontology/
references/
queries.md
schema.md
scripts/
ontology.py
SKILL.md
proactive-agent/
SKILL.md
project_management/
SKILL.md
self-improving-agent/
hooks/
post-bash.sh
pre-tool.sh
session-end.sh
memory/
semantic-patterns.json
README.md
references/
appendix.md
SKILL.md
templates/
correction-template.md
pattern-template.md
validation-template.md
task_analysis/
SKILL.md
task_routing/
SKILL.md
work-principles/
SKILL.md
work_principles.md
00005/
launch.sh
manifest.json
profile.yaml
role_guide.md
skills/
client_relations/
SKILL.md
contract_review/
SKILL.md
ontology/
references/
queries.md
schema.md
scripts/
ontology.py
SKILL.md
proactive-agent/
SKILL.md
sales_management/
SKILL.md
self-improving-agent/
hooks/
post-bash.sh
pre-tool.sh
session-end.sh
memory/
semantic-patterns.json
README.md
references/
appendix.md
SKILL.md
templates/
correction-template.md
pattern-template.md
validation-template.md
work-principles/
SKILL.md
work_principles.md
profile_template.yaml
nicknames.txt
piggy.jpg
sops/
hr_operations_sop.md
workflows/
hiring_workflow.md
offboarding_workflow.md
onboarding_workflow.md
project_intake_workflow.md
project_retrospective_workflow.md
operations/
sops/
coo_delegation_sop.md
cso_sales_operations_sop.md
ea_dispatch_authority_sop.md
project_execution_sop.md
project_intake_sop.md
project_management_tracking.md
role_archetype_templates.md
self_verification_sop.md
task_dispatch_and_acceptance_sop.md
task_lifecycle_states.md
workflow_schema.md
sales/
playbooks/
external_comms/
changelog.md
external_comms_playbook.md
shared_prompts/
Anti_Cloud_Acceptance_Training_v1.md
code_engineering_standards.md
efficiency.md
frontend_code_engineering_standards.md
model_downgrade_strategy.md
oneonone_workspace_policy.md
Risk_Monitoring_and_Early_Warning_Guide.md
roblox_game_design.md.md
task_flow_tracking_and_anomaly_monitoring.md
tool_usage.md
work_approach.md
config.yaml
CONTRIBUTING.md
docs/
_config.yml
architecture_zh.md
architecture.md
design-principles.md
dev-test-workflow.md
docs/
404.html
assets/
images/
favicon.png
javascripts/
bundle.79ae519e.min.js
bundle.79ae519e.min.js.map
lunr/
min/
lunr.ar.min.js
lunr.da.min.js
lunr.de.min.js
lunr.du.min.js
lunr.el.min.js
lunr.es.min.js
lunr.fi.min.js
lunr.fr.min.js
lunr.he.min.js
lunr.hi.min.js
lunr.hu.min.js
lunr.hy.min.js
lunr.it.min.js
lunr.ja.min.js
lunr.jp.min.js
lunr.kn.min.js
lunr.ko.min.js
lunr.multi.min.js
lunr.nl.min.js
lunr.no.min.js
lunr.pt.min.js
lunr.ro.min.js
lunr.ru.min.js
lunr.sa.min.js
lunr.stemmer.support.min.js
lunr.sv.min.js
lunr.ta.min.js
lunr.te.min.js
lunr.th.min.js
lunr.tr.min.js
lunr.vi.min.js
lunr.zh.min.js
tinyseg.js
wordcut.js
workers/
search.2c215733.min.js
search.2c215733.min.js.map
stylesheets/
main.484c7ddc.min.css
main.484c7ddc.min.css.map
palette.ab4e12ef.min.css
palette.ab4e12ef.min.css.map
guide/
coaching/
index.html
company-config/
index.html
cost-tracking/
index.html
execution-modes/
index.html
file-approval/
index.html
getting-started/
index.html
hiring/
index.html
meetings/
index.html
performance/
index.html
task-management/
index.html
index.html
reference/
architecture/
index.html
task-system/
index.html
vessel-system/
index.html
search/
search_index.json
sitemap.xml
sitemap.xml.gz
zh/
guide/
coaching/
index.html
company-config/
index.html
cost-tracking/
index.html
execution-modes/
index.html
file-approval/
index.html
getting-started/
index.html
hiring/
index.html
meetings/
index.html
performance/
index.html
task-management/
index.html
index.html
reference/
architecture/
index.html
task-system/
index.html
vessel-system/
index.html
google5575e9099405f85b.html
img/
apple-touch-icon.png
cover.png
favicon-16.png
favicon-32.png
... 642 moreFAQ
onemancompany is a Claude Code plugin with 35 hand-picked skills for automation work, indexed on Flowy. Install it with the command on its page. It includes hiring, ontology, people_management. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.