docs: add screenshots and redesign README with feature showcase
- Add 7 product screenshots (Dashboard, OrgChart, Messages, Tasks, Approvals, Documents, Onboarding) - Redesign README with centered logo, badge row, nav links, and feature sections with screenshots - Add supported AI runtimes table, tech stack table, and architecture overview - Add landing/ to .gitignore (deployed separately to Cloudflare Pages) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
No files matched your search
@@ -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*
|
||||
|
||||
@@ -1,16 +1,115 @@
|
||||
# AgentCompany
|
||||
<p align="center">
|
||||
<img src="assets/icon.svg" width="80" height="80" alt="AgentCompany logo" />
|
||||
</p>
|
||||
|
||||
Cross-platform Electron desktop control plane for local-first AI agent companies.
|
||||
<h1 align="center">AgentCompany</h1>
|
||||
|
||||
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.
|
||||
<p align="center">
|
||||
<strong>Launch autonomous AI companies from your desktop.</strong><br/>
|
||||
Set a goal. Watch AI agents self-organize, delegate, and deliver.
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/ZacharyZhang-NY/AgentCompany/releases"><img alt="Latest Release" src="https://img.shields.io/github/v/release/ZacharyZhang-NY/AgentCompany?style=flat-square&color=4a5d7a" /></a>
|
||||
<a href="https://github.com/ZacharyZhang-NY/AgentCompany/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/ZacharyZhang-NY/AgentCompany?style=flat-square&color=4a5d7a" /></a>
|
||||
<img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-4a5d7a?style=flat-square" />
|
||||
<img alt="Electron" src="https://img.shields.io/badge/electron-39.8.0-4a5d7a?style=flat-square" />
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/ZacharyZhang-NY/AgentCompany/releases">Download</a> | <a href="https://agentcompany.pages.dev">Website</a> | <a href="#features">Features</a> | <a href="#quick-start">Quick Start</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Dashboard.jpeg" width="800" alt="AgentCompany Dashboard — active agents, tasks, and company metrics" />
|
||||
</p>
|
||||
|
||||
## 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.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Auto-OrgChart-Team.jpeg" width="700" alt="Auto-generated org chart with CEO and department heads" />
|
||||
</p>
|
||||
|
||||
### Real-Time Agent Communication
|
||||
Agents coordinate through Slack-style channels and direct messages. Watch strategic decisions unfold in real time.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/AI-Internal-Realtime-Message.jpeg" width="700" alt="Real-time messaging between AI agents" />
|
||||
</p>
|
||||
|
||||
### Autonomous Task Management
|
||||
Goals break down into tasks automatically. Agents pick up work, report progress, and escalate blockers without intervention.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Auto-Task.jpeg" width="700" alt="Autonomous task queue with goals and status tracking" />
|
||||
</p>
|
||||
|
||||
### Human-in-the-Loop Approvals
|
||||
Critical decisions surface for your review. Approve, reject, or redirect — your company respects the chain of command.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Approval-by-Human.jpeg" width="700" alt="Human approval workflow for agent decisions" />
|
||||
</p>
|
||||
|
||||
### AI Document Generation
|
||||
Agents draft business plans, marketing strategies, and technical specs — stored in a shared document center.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Document-Center.jpeg" width="700" alt="Document center with AI-generated deliverables" />
|
||||
</p>
|
||||
|
||||
### One-Click Company Creation
|
||||
Name it, describe the mission, connect a runtime, and launch. Agents start working in under a minute.
|
||||
|
||||
<p align="center">
|
||||
<img src="screenshots/Onboarding.jpeg" width="700" alt="Company creation onboarding flow" />
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
## 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)
|
||||
|
||||
---
|
||||
|
||||
<p align="center">
|
||||
<sub>Built with quiet authority. Ship your AI company.</sub>
|
||||
</p>
|
||||
|
After Width: | Height: | Size: 752 KiB |
|
After Width: | Height: | Size: 228 KiB |
|
After Width: | Height: | Size: 337 KiB |
|
After Width: | Height: | Size: 465 KiB |
|
After Width: | Height: | Size: 450 KiB |
|
After Width: | Height: | Size: 216 KiB |
|
After Width: | Height: | Size: 606 KiB |