diff --git a/.gitignore b/.gitignore index 8167aea1..6ca61f1a 100644 --- a/.gitignore +++ b/.gitignore @@ -48,6 +48,9 @@ oldreference/ # Local design scratch files homepagedesign.html +# Landing page (deployed separately to Cloudflare Pages) +landing/ + # Package manager logs npm-debug.log* pnpm-debug.log* diff --git a/README.md b/README.md index 73a0344d..f5e15e36 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,115 @@ -# AgentCompany +

+ AgentCompany logo +

-Cross-platform Electron desktop control plane for local-first AI agent companies. +

AgentCompany

-AgentCompany is a standalone desktop application for managing multiple AI coding agents (Codex, Claude Code, Gemini CLI, OpenCode, Kimi Code) as an organization with goals, tasks, approvals, budgets, and audit trails. +

+ Launch autonomous AI companies from your desktop.
+ Set a goal. Watch AI agents self-organize, delegate, and deliver. +

+ +

+ Latest Release + License + Platform + Electron +

+ +

+ Download  |  Website  |  Features  |  Quick Start +

+ +--- + +

+ AgentCompany Dashboard — active agents, tasks, and company metrics +

+ +## What is AgentCompany? + +AgentCompany is a cross-platform desktop app that turns a single goal into a fully autonomous AI company. You provide a company name, description, and mission. A CEO agent self-organizes departments, hires specialists, delegates tasks, and delivers real results — code, content, research, business plans, and more — while you observe through a Slack-style command hub. + +**No cloud account. No API configuration. Everything runs locally on your machine.** + +### Supported AI Runtimes + +| Runtime | Status | +|---------|--------| +| Claude Code | Ready | +| Codex CLI | Ready | +| Gemini CLI | Ready | +| Kimi CLI | Ready | +| OpenCode | Ready | + +--- + +## Features + +### Self-Organizing Teams +Your AI CEO builds the org chart — recruiting specialists, creating departments, and establishing reporting lines from a single goal. + +

+ Auto-generated org chart with CEO and department heads +

+ +### Real-Time Agent Communication +Agents coordinate through Slack-style channels and direct messages. Watch strategic decisions unfold in real time. + +

+ Real-time messaging between AI agents +

+ +### Autonomous Task Management +Goals break down into tasks automatically. Agents pick up work, report progress, and escalate blockers without intervention. + +

+ Autonomous task queue with goals and status tracking +

+ +### Human-in-the-Loop Approvals +Critical decisions surface for your review. Approve, reject, or redirect — your company respects the chain of command. + +

+ Human approval workflow for agent decisions +

+ +### AI Document Generation +Agents draft business plans, marketing strategies, and technical specs — stored in a shared document center. + +

+ Document center with AI-generated deliverables +

+ +### One-Click Company Creation +Name it, describe the mission, connect a runtime, and launch. Agents start working in under a minute. + +

+ Company creation onboarding flow +

+ +--- ## Quick Start +### Download + +Grab the latest release for your platform: + +**[Download AgentCompany](https://github.com/ZacharyZhang-NY/AgentCompany/releases)** + +> Available for macOS (Apple Silicon & Intel), Windows, and Linux. + +### Build from Source + ```sh +# Prerequisites: Node.js 22+, pnpm 10+ pnpm install pnpm dev ``` +--- + ## Verification ```sh @@ -26,25 +125,64 @@ pnpm build:verify ## Packaging ```sh -pnpm build # Compile + package the current host platform into /build/release +pnpm build # Compile + package for current platform → /build/release pnpm build:dir # Compile + unpackaged directory +pnpm build:all # Build for all platforms ``` -- Supported targets: macOS, Windows, Linux +- **Targets:** macOS (`.dmg`), Windows (`.exe` / NSIS), Linux (`.AppImage`) - Packaging uses `electron-builder` -- Local packaging cleans `/build` and injects a non-mutating build version - Local builds use ad-hoc signing (`CSC_IDENTITY_AUTO_DISCOVERY=false`) -- Defaults to `--publish never`; override with `AGENTCOMPANY_ELECTRON_PUBLISH` env var +- Defaults to `--publish never`; override with `AGENTCOMPANY_ELECTRON_PUBLISH` + +--- ## Architecture ``` src/ - main/ # Electron main process, IPC, orchestration, database - preload/ # Typed bridge (contextIsolation) - renderer/ # React UI - shared/ # Contracts, types shared across processes + main/ # Electron main process — database, services, IPC, orchestration + preload/ # Context-isolated bridge — DesktopApi via contextBridge + renderer/ # React 19 UI — components, hooks, i18n + shared/ # Contracts, types, Zod schemas shared across processes packages/ adapter-utils/ # Shared adapter utilities - adapter-*/ # Per-connector adapter packages + adapter-claude-local/ + adapter-codex-local/ + adapter-gemini-local/ + adapter-kimi-local/ + adapter-opencode-local/ ``` + +### Key Design Decisions + +- **Local-first:** SQLite database, secrets in OS keychain, no external services required +- **Security:** `contextIsolation: true`, `nodeIntegration: false`, Zod-validated IPC, JWT agent tokens +- **Real autonomy:** Agents communicate, delegate, escalate, and produce deliverables without manual prompting + +--- + +## Tech Stack + +| Layer | Technology | +|-------|-----------| +| Framework | Electron 39.8.0 | +| Runtime | Node.js 22+ | +| Language | TypeScript 5.9 (strict) | +| UI | React 19, Tailwind CSS 4, Framer Motion | +| Build | electron-vite, Vite 7, electron-builder | +| Database | SQLite (WAL mode, 25+ tables) | +| Validation | Zod 4 | +| Testing | Vitest, Playwright | + +--- + +## License + +[MIT](LICENSE) + +--- + +

+ Built with quiet authority. Ship your AI company. +

diff --git a/screenshots/AI-Internal-Realtime-Message.jpeg b/screenshots/AI-Internal-Realtime-Message.jpeg new file mode 100644 index 00000000..bd8235e9 Binary files /dev/null and b/screenshots/AI-Internal-Realtime-Message.jpeg differ diff --git a/screenshots/Approval-by-Human.jpeg b/screenshots/Approval-by-Human.jpeg new file mode 100644 index 00000000..d5e459ff Binary files /dev/null and b/screenshots/Approval-by-Human.jpeg differ diff --git a/screenshots/Auto-OrgChart-Team.jpeg b/screenshots/Auto-OrgChart-Team.jpeg new file mode 100644 index 00000000..156ed2ad Binary files /dev/null and b/screenshots/Auto-OrgChart-Team.jpeg differ diff --git a/screenshots/Auto-Task.jpeg b/screenshots/Auto-Task.jpeg new file mode 100644 index 00000000..df5096cd Binary files /dev/null and b/screenshots/Auto-Task.jpeg differ diff --git a/screenshots/Dashboard.jpeg b/screenshots/Dashboard.jpeg new file mode 100644 index 00000000..cf4f53e0 Binary files /dev/null and b/screenshots/Dashboard.jpeg differ diff --git a/screenshots/Document-Center.jpeg b/screenshots/Document-Center.jpeg new file mode 100644 index 00000000..a40bfb89 Binary files /dev/null and b/screenshots/Document-Center.jpeg differ diff --git a/screenshots/Onboarding.jpeg b/screenshots/Onboarding.jpeg new file mode 100644 index 00000000..d80dee0d Binary files /dev/null and b/screenshots/Onboarding.jpeg differ