@1mancompany/onemancompany 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,412 @@
+<p align="center">
+  <img src="img/omc.png" alt="OneManCompany" />
+</p>
+
+---
+
+<h1 align="center">OneManCompany</h1>
+
+<p align="center"><b>The AI Operating System for One-Person Companies</b></p>
+
+<p align="center">
+  <a href="README_zh.md">中文文档</a>&nbsp;&nbsp;·&nbsp;&nbsp;<a href="https://carbonkites.com">Talent Market</a>&nbsp;&nbsp;·&nbsp;&nbsp;<a href="https://github.com/1mancompany/OneManCompany/issues">Issues</a>
+</p>
+
+> 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.
+
+**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.*)
+
+🏢 **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.
+
+📈 **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.
+
+🛡️ **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](https://carbonkites.com)** of community-verified AI employees.
+
+⚙️ **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.
+
+```bash
+npx @carbonkite/onemancompany
+```
+
+> One command. A full AI company in your browser. No Python, no Docker, no config — just run it.
+
+---
+
+## Features
+
+<table>
+  <tr>
+    <td width="33%">
+      <h3>🏢 Pixel-Art Office</h3>
+      Open your browser to a retro office. Your AI employees sit at their desks, work on tasks, and hold meetings — all visualized in real time.
+    </td>
+    <td width="33%">
+      <h3>🤝 Multi-Agent Meetings</h3>
+      Employees pull each other into meetings to align — no babysitting needed. Want to micromanage? Join the meeting and steer it yourself.
+    </td>
+    <td width="33%">
+      <h3>🔍 Your Level of Control</h3>
+      Hands-off? Just review the final result. Hands-on? Join discussions, review every diff, coach employees mid-task. You choose the granularity — from "just show me results" to full micromanagement.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      <h3>🏪 Talent Market</h3>
+      Not another "bring your own agent" framework. HR searches a community-verified marketplace, interviews candidates, and onboards them — you just say "I need a designer."
+    </td>
+    <td>
+      <h3>🧠 1-on-1 Coaching</h3>
+      Not a one-off prompt tweak. Sit down with an employee, explain what you want — it becomes permanent work experience. Next task, they already know your standards.
+    </td>
+    <td>
+      <h3>📊 Performance Reviews</h3>
+      Quarterly evaluations with real consequences. Probation, PIP, promotion — or termination. Your AI employees know the stakes. Yes, they get nervous.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      <h3>🔁 Iteration Management</h3>
+      V1 → V2 → V3 → "actually, let's go back to V1." Sound familiar? Every project has structured version control with full history. Your team iterates until you're happy — or until you realize the first draft was right all along.
+    </td>
+    <td>
+      <h3>👔 Hire & Fire</h3>
+      One click to hire from the Talent Market. Not performing? Coach them, PIP them, or fire them — the next one will be better.
+    </td>
+    <td>
+      <h3>🔄 Self-Evolution</h3>
+      Employees grow through coaching, sharpen through retrospectives, and become legends through project after project. The org evolves too — repeated tasks auto-distill into workflows that only get smoother.
+    </td>
+  </tr>
+</table>
+
+<p align="center">
+  <img src="img/task_tree.jpg" alt="OneManCompany — Task Tree" width="80%" />
+  <br><i>Hierarchical task breakdown — CEO delegates, AI employees execute.</i>
+</p>
+
+---
+
+## How It Works
+
+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"*
+
+1. Your **EA** receives the task and routes it
+2. Your **COO** breaks it down and dispatches subtasks
+3. Engineers, designers, and QA **work autonomously**
+4. They hold **meetings** to align when needed
+5. Work goes through **review, iteration, and quality gates**
+6. You get notified and approve the final result
+
+**You manage. AI executes.**
+
+```text
+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.
+
+---
+
+## What You Can Build
+
+| 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.
+
+### How We're Different
+
+|                                | Typical Agent Orchestrators          | OneManCompany                                                          |
+| ------------------------------ | ------------------------------------ | ---------------------------------------------------------------------- |
+| **Agent architecture**         | Flat task runners, BYOA              | Vessel + Talent separation — modular architecture with Harness protocols |
+| **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 |
+| **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                    |
+
+---
+
+## Quick Start
+
+You only need **Node.js 16+** and **Git**. Everything else is installed automatically.
+
+```bash
+npx @carbonkite/onemancompany
+```
+
+<details>
+<summary><b>macOS</b></summary>
+
+```bash
+# Install Git (if not already installed)
+xcode-select --install
+
+# Launch (auto-installs UV + Python 3.12 + dependencies)
+npx @carbonkite/onemancompany
+```
+
+</details>
+
+<details>
+<summary><b>Windows</b></summary>
+
+```powershell
+# Install Git: https://git-scm.com/download/win
+# Install Node.js: https://nodejs.org/
+
+# Launch (auto-installs UV + Python 3.12 + dependencies)
+npx @carbonkite/onemancompany
+```
+
+</details>
+
+<details>
+<summary><b>Linux (Ubuntu/Debian)</b></summary>
+
+```bash
+# Install prerequisites
+sudo apt update && sudo apt install -y git nodejs npm
+
+# Launch (auto-installs UV + Python 3.12 + dependencies)
+npx @carbonkite/onemancompany
+```
+
+</details>
+
+First run automatically:
+
+1. Installs **UV** (fast Python package manager)
+2. Installs **Python 3.12** via UV (isolated, no system changes)
+3. Clones the repository
+4. Creates venv and installs dependencies
+5. Launches the setup wizard (API keys, Talent Market config)
+
+Then open `http://localhost:8000`. Congratulations, you're a CEO now.
+
+### Execution Modes
+
+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 wizard) |
+| **Claude Code** | More capable, lower token cost | Install [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) + [Claude Pro/Max subscription](https://claude.ai) |
+| **OpenClaw** | Open-source alternative, multiple LLM backends | Install [OpenClaw CLI](https://github.com/anthropics/openclaw) + compatible LLM API Key |
+
+Defaults to Company Hosted Agent — no extra subscription needed to get started. See [Execution Modes docs](https://carbonkite.github.io/OneManCompany/docs/guide/execution-modes/) for details.
+
+### Manage Your Service
+
+```bash
+# Restart / auto-update
+npx @carbonkite/onemancompany
+
+# Debug mode (foreground with logs, Ctrl+C to stop)
+npx @carbonkite/onemancompany --debug
+
+# Stop background service
+npx @carbonkite/onemancompany stop
+
+# Re-run setup wizard (change API keys, etc.)
+npx @carbonkite/onemancompany init
+
+# Custom port
+npx @carbonkite/onemancompany --port 8080
+
+# Uninstall (stops service + deletes installation)
+npx @carbonkite/onemancompany uninstall
+```
+
+### Manual Install (Dev Mode)
+
+```bash
+# 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
+```
+
+### Configuration Files
+
+| File                         | Purpose                                |
+| ---------------------------- | -------------------------------------- |
+| `.onemancompany/.env`        | API keys (OpenRouter, Anthropic, etc.) |
+| `.onemancompany/config.yaml` | App config (Talent Market URL, etc.)   |
+| Browser Settings panel       | Frontend preferences                   |
+
+---
+
+## Under the Hood
+
+### Why It's an OS, Not Just a Company
+
+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:
+
+1. **Unified Runtime** — Abstracts away AI differences. You don't need to know if your employee runs on Claude Code or OpenClaw — the Vessel layer handles scheduling, retries, and communication uniformly.
+2. **Install Employees Like Apps** — Phone OS has an app store; we have a Talent Market. Need a designer? HR hires one, plug and play. Not performing? Fire them — the next one will be better.
+3. **Same System, Different Company** — Swap the Direction, Culture, and Talents, and you have an entirely different company. A game studio today, a dev agency tomorrow.
+
+### Built Like a Real Company
+
+We faithfully modeled how Fortune 500 companies actually operate:
+
+- **Org chart & reporting lines** — hierarchical management, department-based structure
+- **Hiring & onboarding** — HR searches Talent Market, CEO interviews, automated onboarding flow
+- **Firing & offboarding** — yes, you can fire underperformers (with proper cleanup, not just `kill -9`)
+- **Performance reviews** — quarterly scoring, probation, PIP, promotion tracks
+- **Task delegation & approval chains** — CEO → executives → employees, with quality gates at every level
+- **Meeting rooms** — multi-agent synchronous discussions with meeting reports
+- **Knowledge base & SOPs** — company culture, direction docs, workflow definitions
+- **File change approvals** — employees propose edits, CEO reviews diffs and approves in batch
+- **Cost accounting** — per-project LLM token usage and USD cost tracking
+- **1-on-1 coaching** — CEO guidance sessions that permanently shape employee behavior
+- **Hot reload & graceful restart** — zero-downtime deployments for AI companies
+
+Something missing? [Open an issue](https://github.com/1mancompany/OneManCompany/issues) or build it yourself — that's the beauty of open source.
+
+### Why We Deliver Product-Grade Output
+
+Scattered AI tools stop at draft-quality output. OneManCompany replicates full business processes to minimize human intervention:
+
+- **Enterprise-style task orchestration** — Automatically breaks complex projects into specialized phases (requirements → design → development → testing → deployment), assigns owners, and coordinates like a real team.
+- **Smart talent matching** — The recruiting agent matches the right AI employee to every role, ensuring skills align precisely with task demands.
+- **Closed-loop evolution** — After delivery, the system runs retrospectives, captures lessons learned, and optimizes workflows. Every project makes the entire organization better.
+
+### The Vessel + Talent System
+
+Think of it like **EVA or Gundam** — a powerful mech that comes alive when a pilot is plugged in.
+
+- **Vessel** (the mech) = execution container. Defines how an employee runs: retry logic, timeouts, tool access, communication protocols.
+- **Talent** (the pilot) = capability package. Brings skills, knowledge, personality, and specialized tools.
+- **Employee** = Vessel + Talent. Hire from the Talent Market, and the system handles the rest.
+
+> For a deep dive into the Vessel architecture, see [docs/vessel-system.md](docs/vessel-system.md).
+
+---
+
+## Open Ecosystem
+
+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.
+
+---
+
+## Vision & Roadmap
+
+**Near-term:** Enable 100 AI one-person 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 |
+
+### TODO
+
+- [ ] More built-in tools (Kanban board, progress visualization, Gantt chart, etc.)
+- [ ] Selectable frontend themes (futuristic, cyberpunk, minimalist, pixel-art, etc.)
+- [ ] More LLM provider options (Ollama local, Azure OpenAI, AWS Bedrock, etc.)
+- [ ] More efficient AI collaboration (multi-agent handoff, parallel execution, conflict resolution)
+- [ ] More efficient company-hosted agent Vessel logic (smarter retry, context carryover, cost-aware scheduling)
+
+Contributions welcome — we encourage vibe-coding. AI contributors please follow the [vibe-coding-guide](vibe-coding-guide.md).
+
+This is a living plan — [request a feature](https://github.com/1mancompany/OneManCompany/issues) or [contribute directly](https://github.com/1mancompany/OneManCompany/pulls).
+
+---
+
+## Documentation
+
+**[Full Documentation Site](https://carbonkite.github.io/OneManCompany/docs/)** — Feature guides, usage instructions, and technical reference.
+
+| Guide | Description |
+| --- | --- |
+| [Getting Started](https://carbonkite.github.io/OneManCompany/docs/guide/getting-started/) | First-time setup and your first task |
+| [Execution Modes](https://carbonkite.github.io/OneManCompany/docs/guide/execution-modes/) | Company Hosted Agent vs Claude Code |
+| [Task Management](https://carbonkite.github.io/OneManCompany/docs/guide/task-management/) | Create, delegate, review, and approve tasks |
+| [Hiring & Talent Market](https://carbonkite.github.io/OneManCompany/docs/guide/hiring/) | Find and hire AI employees |
+| [1-on-1 Coaching](https://carbonkite.github.io/OneManCompany/docs/guide/coaching/) | Shape employee behavior permanently |
+| [Performance Reviews](https://carbonkite.github.io/OneManCompany/docs/guide/performance/) | Evaluate, promote, or fire employees |
+
+| Technical Reference | Description |
+| --- | --- |
+| [Architecture](docs/architecture.md) | System architecture, diagrams, module index, design philosophy |
+| [Vessel System](docs/vessel-system.md) | Vessel + Talent deep dive, Harness protocols |
+| [Task System](docs/task-system.md) | Task status state machine |
+| [Coding Guide](vibe-coding-guide.md) | Coding guidelines, testing rules, code style |
+| [Changelog](CHANGELOG.md) | Release history |
+
+---
+
+## Community & Contributing
+
+- **Build Talents** — Create new AI employee types for the Talent Market
+- **Build Tools** — Add integrations (APIs, services, platforms)
+- **Add Company Features** — Performance dashboards, OKR tracking, employee training...
+- **Improve the OS** — Core engine, frontend, documentation
+- **Share Demos** — Show what your AI company can build
+- **Report Issues** — Help us find and fix bugs
+
+See [vibe-coding-guide.md](vibe-coding-guide.md) for coding guidelines.
+
+---
+
+## Citation
+
+If you use OneManCompany in your research or project, please cite it:
+
+```bibtex
+@software{onemancompany2025,
+  title = {OneManCompany: The AI Operating System for One-Person Companies},
+  author = {Zhengxu Yu, Fu Yu, Zhiyuan He, Yuxuan Huang, Weilin Luo, Jun Wang},
+  url = {https://github.com/1mancompany/OneManCompany},
+  year = {2025},
+  license = {Apache-2.0}
+}
+```
+
+---
+
+## Links
+
+**[Talent Market](https://carbonkites.com)** — Community-verified AI employee marketplace (Trained a 🦞 but not sure what to do with it? List it on the market!)
+
+**[Talent Template](https://github.com/1mancompany/talent-template)** — Template repo for building your own Talents
+
+---
+
+## License
+
+[Apache License 2.0](LICENSE) — Free for commercial use and modification, with attribution required.

package/bin/cli.js

@@ -0,0 +1,435 @@
+#!/usr/bin/env node
+
+/**
+ * OneManCompany CLI — npx @carbonkite/onemancompany
+ *
+ * Zero-prerequisites launcher. Automatically installs UV and Python if needed.
+ * Works on Windows, macOS, and Linux.
+ */
+
+const { execSync, spawn, spawnSync } = require("child_process");
+const readline = require("readline");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+// ── Config ──────────────────────────────────────────────────────────────────
+const REPO_URL = "https://github.com/1mancompany/OneManCompany.git";
+const DIR_NAME = "OneManCompany";
+const PYTHON_VERSION = "3.12";
+
+// ── Colors ──────────────────────────────────────────────────────────────────
+const cyan = (s) => `\x1b[1;36m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[1;33m${s}\x1b[0m`;
+const red = (s) => `\x1b[1;31m${s}\x1b[0m`;
+const green = (s) => `\x1b[1;32m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+
+const info = (msg) => console.log(cyan(`▸ ${msg}`));
+const warn = (msg) => console.log(yellow(`⚠ ${msg}`));
+const fail = (msg) => {
+  console.error(red(`✖ ${msg}`));
+  process.exit(1);
+};
+
+const isWindows = os.platform() === "win32";
+const PID_FILE = ".onemancompany.pid";
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+function findInstallDir() {
+  const dirFromArgs = (() => {
+    const args = process.argv.slice(2);
+    for (let i = 0; i < args.length; i++) {
+      if (args[i] === "--dir" && args[i + 1]) return path.resolve(args[i + 1]);
+    }
+    return null;
+  })();
+  return dirFromArgs || path.resolve(process.cwd(), DIR_NAME);
+}
+
+function writePidFile(installDir, pid) {
+  fs.writeFileSync(path.join(installDir, PID_FILE), String(pid));
+}
+
+function readPidFile(installDir) {
+  const pidPath = path.join(installDir, PID_FILE);
+  if (!fs.existsSync(pidPath)) return null;
+  const pid = parseInt(fs.readFileSync(pidPath, "utf-8").trim(), 10);
+  return isNaN(pid) ? null : pid;
+}
+
+function removePidFile(installDir) {
+  const pidPath = path.join(installDir, PID_FILE);
+  if (fs.existsSync(pidPath)) fs.unlinkSync(pidPath);
+}
+
+function isProcessRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function stopService(installDir) {
+  const pid = readPidFile(installDir);
+  if (pid && isProcessRunning(pid)) {
+    info(`Stopping OneManCompany service (PID ${pid})...`);
+    try {
+      process.kill(pid, "SIGTERM");
+      // Wait up to 5s for graceful shutdown
+      for (let i = 0; i < 50; i++) {
+        if (!isProcessRunning(pid)) break;
+        spawnSync("sleep", ["0.1"]);
+      }
+      if (isProcessRunning(pid)) {
+        process.kill(pid, "SIGKILL");
+      }
+      info("Service stopped");
+    } catch {
+      warn("Could not stop service — it may have already exited");
+    }
+  }
+  removePidFile(installDir);
+}
+function commandExists(cmd) {
+  try {
+    if (isWindows) {
+      execSync(`where ${cmd}`, { stdio: "ignore" });
+    } else {
+      execSync(`command -v ${cmd}`, { stdio: "ignore" });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function run(cmd, opts = {}) {
+  return execSync(cmd, { stdio: "inherit", ...opts });
+}
+
+function runShell(cmd, opts = {}) {
+  return execSync(cmd, { stdio: "inherit", shell: true, ...opts });
+}
+
+// ── UV installer ────────────────────────────────────────────────────────────
+function ensureUV() {
+  if (commandExists("uv")) {
+    const ver = execSync("uv --version").toString().trim();
+    info(`Found ${ver}`);
+    return;
+  }
+
+  info("Installing UV (fast Python package manager)...");
+
+  try {
+    if (isWindows) {
+      runShell("powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"");
+    } else {
+      runShell("curl -LsSf https://astral.sh/uv/install.sh | sh");
+    }
+  } catch (e) {
+    fail(
+      "Failed to install UV automatically.\n" +
+      "Please install it manually: https://docs.astral.sh/uv/getting-started/installation/\n" +
+      `Error: ${e.message}`
+    );
+  }
+
+  // Add UV to PATH for the current session
+  const home = os.homedir();
+  const uvBinPaths = isWindows
+    ? [path.join(home, ".cargo", "bin")]
+    : [path.join(home, ".local", "bin"), path.join(home, ".cargo", "bin")];
+
+  for (const p of uvBinPaths) {
+    if (fs.existsSync(path.join(p, isWindows ? "uv.exe" : "uv"))) {
+      process.env.PATH = `${p}${path.delimiter}${process.env.PATH}`;
+      break;
+    }
+  }
+
+  if (!commandExists("uv")) {
+    fail(
+      "UV was installed but not found in PATH.\n" +
+      "Please restart your terminal and try again, or add UV to your PATH manually."
+    );
+  }
+
+  info(`Installed ${execSync("uv --version").toString().trim()}`);
+}
+
+// ── Python via UV ───────────────────────────────────────────────────────────
+function ensurePython() {
+  // Check if UV-managed Python exists
+  try {
+    const ver = execSync(`uv python find ${PYTHON_VERSION} 2>&1`).toString().trim();
+    if (ver) {
+      info(`Found Python at ${ver}`);
+      return;
+    }
+  } catch {}
+
+  info(`Installing Python ${PYTHON_VERSION} via UV...`);
+  try {
+    runShell(`uv python install ${PYTHON_VERSION}`);
+    info(`Python ${PYTHON_VERSION} installed`);
+  } catch (e) {
+    fail(`Failed to install Python ${PYTHON_VERSION}: ${e.message}`);
+  }
+}
+
+// ── Main ────────────────────────────────────────────────────────────────────
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Help
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`
+${cyan("OneManCompany")} — The AI Operating System for One-Person Companies
+
+${green("Usage:")}
+  npx @carbonkite/onemancompany              Start (runs in background)
+  npx @carbonkite/onemancompany --debug      Start with logs (Ctrl+C to stop)
+  npx @carbonkite/onemancompany stop         Stop background service
+  npx @carbonkite/onemancompany init         Re-run setup wizard
+  npx @carbonkite/onemancompany uninstall    Stop service and remove installation
+  npx @carbonkite/onemancompany --port 8080  Custom port
+  npx @carbonkite/onemancompany --dir ./my   Custom install directory
+
+${green("Options:")}
+  --dir <path>    Install directory (default: ./OneManCompany)
+  --port <port>   Server port (default: 8000)
+  --debug         Run in foreground with logs (default: background)
+  --help, -h      Show this help
+
+${green("What gets installed automatically:")}
+  1. UV        — Fast Python package manager  ${dim("(https://astral.sh/uv)")}
+  2. Python    — ${PYTHON_VERSION}+ via UV               ${dim("(managed, no system changes)")}
+  3. Project   — Cloned from GitHub            ${dim("(into current directory)")}
+`);
+    return;
+  }
+
+  // ── Uninstall ─────────────────────────────────────────────────────────
+  if (args[0] === "uninstall") {
+    const installDir = findInstallDir();
+    if (!fs.existsSync(installDir)) {
+      warn(`No installation found at ${installDir}`);
+      return;
+    }
+
+    const answer = await ask(
+      yellow("⚠") + `  This will stop the service and delete ${installDir}\n` +
+      "  Are you sure? [y/N] "
+    );
+    if (answer !== "y" && answer !== "yes") {
+      console.log("  Aborted.");
+      return;
+    }
+
+    stopService(installDir);
+
+    info(`Removing ${installDir}...`);
+    fs.rmSync(installDir, { recursive: true, force: true });
+    info("OneManCompany has been uninstalled.");
+    console.log(dim(`  To reinstall: npx @carbonkite/onemancompany`));
+    return;
+  }
+
+  // ── Stop ────────────────────────────────────────────────────────────
+  if (args[0] === "stop") {
+    const installDir = findInstallDir();
+    const pid = readPidFile(installDir);
+    if (pid && isProcessRunning(pid)) {
+      stopService(installDir);
+      console.log(green("  ✓ OneManCompany stopped."));
+    } else {
+      warn("No running OneManCompany service found.");
+      removePidFile(installDir);
+    }
+    return;
+  }
+
+  console.log();
+  console.log(cyan("╔═══════════════════════════════════════════════╗"));
+  console.log(cyan("║   OneManCompany — AI Company OS       ║"));
+  console.log(cyan("╚═══════════════════════════════════════════════╝"));
+  console.log();
+
+  // ── Check git ─────────────────────────────────────────────────────────
+  if (!commandExists("git")) {
+    fail(
+      "Git is required but not found.\n" +
+      (isWindows
+        ? "Install from https://git-scm.com/download/win"
+        : os.platform() === "darwin"
+          ? "Run: xcode-select --install"
+          : "Run: sudo apt install git  (or your distro's equivalent)")
+    );
+  }
+
+  // ── Install UV + Python ───────────────────────────────────────────────
+  ensureUV();
+  ensurePython();
+
+  // ── Parse args ────────────────────────────────────────────────────────
+  let installDir = path.resolve(process.cwd(), DIR_NAME);
+  const passthrough = [];
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--dir" && args[i + 1]) {
+      installDir = path.resolve(args[++i]);
+    } else {
+      passthrough.push(args[i]);
+    }
+  }
+
+  // ── Clone or update ───────────────────────────────────────────────────
+  if (fs.existsSync(path.join(installDir, ".git"))) {
+    info(`Updating existing installation at ${installDir}`);
+    try {
+      run("git pull --ff-only", { cwd: installDir });
+    } catch {
+      warn("git pull failed — continuing with current version");
+    }
+  } else if (fs.existsSync(installDir)) {
+    info(`Directory ${installDir} exists (not a git repo) — using as-is`);
+  } else {
+    info(`Cloning OneManCompany into ${installDir}...`);
+    run(`git clone --depth 1 ${REPO_URL} "${installDir}"`);
+  }
+
+  // ── Check if already running ─────────────────────────────────────────
+  const existingPid = readPidFile(installDir);
+  if (existingPid && isProcessRunning(existingPid)) {
+    warn("OneManCompany is already running.");
+    const answer = await ask(
+      "  Stop the service and re-setup? [y/N] "
+    );
+    if (answer === "y" || answer === "yes") {
+      stopService(installDir);
+      info("Re-running setup wizard...\n");
+      const pythonBinCheck = isWindows
+        ? path.join(installDir, ".venv", "Scripts", "python.exe")
+        : path.join(installDir, ".venv", "bin", "python");
+      if (fs.existsSync(pythonBinCheck)) {
+        const initResult = spawnSync(pythonBinCheck, ["-m", "onemancompany.onboard"], {
+          cwd: installDir,
+          stdio: "inherit",
+        });
+        if (initResult.status !== 0) fail("Setup wizard failed");
+      }
+    } else {
+      console.log("  Continuing with existing service.");
+      return;
+    }
+  }
+
+  // ── Setup venv + deps via UV ──────────────────────────────────────────
+  const venvDir = path.join(installDir, ".venv");
+  if (!fs.existsSync(venvDir)) {
+    info("Creating virtual environment...");
+    runShell(`uv venv --python ${PYTHON_VERSION}`, { cwd: installDir });
+  }
+
+  info("Installing dependencies...");
+  runShell("uv pip install -e .", { cwd: installDir });
+
+  // ── Launch (directly via Python, all platforms) ────────────────────────
+  const pythonBin = isWindows
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
+
+  if (!fs.existsSync(pythonBin)) {
+    fail(`Python not found at ${pythonBin}. Try deleting .venv and running again.`);
+  }
+
+  const initComplete = fs.existsSync(path.join(installDir, ".onemancompany", ".env"))
+    && fs.existsSync(path.join(installDir, ".onemancompany", "company", "human_resource", "employees"));
+
+  // Run setup wizard if needed
+  if (passthrough[0] === "init" || !initComplete) {
+    info("Running setup wizard...\n");
+    const initResult = spawnSync(pythonBin, ["-m", "onemancompany.onboard"], {
+      cwd: installDir,
+      stdio: "inherit",
+    });
+    if (initResult.status !== 0) fail("Setup wizard failed");
+    if (passthrough[0] === "init") passthrough.shift();
+  }
+
+  // Start server
+  const debugMode = passthrough.includes("--debug");
+  const launchArgs = passthrough.filter((a) => a !== "--debug");
+
+  if (debugMode) {
+    // ── Foreground mode: show logs, Ctrl+C to kill ──────────────────
+    info("Starting OneManCompany in debug mode (Ctrl+C to stop)...\n");
+    const child = spawn(pythonBin, ["-m", "onemancompany.main", ...launchArgs], {
+      cwd: installDir,
+      stdio: "inherit",
+    });
+
+    writePidFile(installDir, child.pid);
+
+    const cleanup = () => { removePidFile(installDir); };
+    child.on("close", (code) => { cleanup(); process.exit(code ?? 0); });
+    child.on("error", (err) => { cleanup(); fail(`Failed to start: ${err.message}`); });
+    process.on("SIGINT", () => { child.kill("SIGTERM"); });
+    process.on("SIGTERM", () => { child.kill("SIGTERM"); });
+  } else {
+    // ── Background mode: detach and exit CLI ────────────────────────
+    info("Starting OneManCompany in background...");
+    const logFile = path.join(installDir, ".onemancompany", "server.log");
+    // Ensure log directory exists
+    const logDir = path.dirname(logFile);
+    if (!fs.existsSync(logDir)) fs.mkdirSync(logDir, { recursive: true });
+
+    const out = fs.openSync(logFile, "a");
+    const err = fs.openSync(logFile, "a");
+
+    const child = spawn(pythonBin, ["-m", "onemancompany.main", ...launchArgs], {
+      cwd: installDir,
+      stdio: ["ignore", out, err],
+      detached: true,
+    });
+
+    writePidFile(installDir, child.pid);
+    child.unref();
+
+    // Wait a moment to check it didn't crash immediately
+    await new Promise((r) => setTimeout(r, 1500));
+    if (isProcessRunning(child.pid)) {
+      console.log();
+      console.log(green("  ✓ OneManCompany is running!"));
+      console.log();
+      console.log(`  ${cyan("→")} Open ${cyan("http://localhost:8000")} in your browser`);
+      console.log(`  ${dim("  Logs:")} ${logFile}`);
+      console.log(`  ${dim("  Stop:")} npx @carbonkite/onemancompany stop`);
+      console.log(`  ${dim("  Debug:")} npx @carbonkite/onemancompany --debug`);
+      console.log();
+    } else {
+      removePidFile(installDir);
+      fail("Server exited unexpectedly. Run with --debug to see logs.");
+    }
+  }
+}
+
+main().catch((err) => {
+  console.error(red(`✖ ${err.message}`));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@1mancompany/onemancompany",
+  "version": "0.1.0",
+  "description": "The AI Operating System for One-Person Companies",
+  "bin": {
+    "onemancompany": "bin/cli.js"
+  },
+  "files": [
+    "bin/cli.js"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "multi-agent",
+    "langchain",
+    "company",
+    "one-man-company",
+    "ai-native",
+    "autonomous-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1mancompany/OneManCompany.git"
+  },
+  "homepage": "https://github.com/1mancompany/OneManCompany",
+  "bugs": {
+    "url": "https://github.com/1mancompany/OneManCompany/issues"
+  },
+  "author": "1mancompany",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=16"
+  }
+}