An AI executive council platform for founders and businesses. A team of autonomous AI agents (CEO, CFO, CTO, COO) that collaborate to help you start and grow your business.
- CEO - Strategic leadership, coordination, and primary interface with founders
- CFO - Financial planning, budgeting, funding strategy, and financial analysis
- CTO - Technology strategy, development guidance, and technical decisions
- COO - Operations, workflows, team management, and process optimization
- Node.js (v18 or later recommended)
- npm or yarn
- Go 1.23+ (for Beads CLI task tracking)
- Git 2.25+
-
Clone the repository:
git clone https://github.com/tony-42069/org-agents.git cd org-agents -
Install dependencies:
npm install cd ui && npm install
-
Install Beads CLI (for task tracking):
go install github.com/steveyegge/beads/cmd/bd@latest
-
Set up environment variables:
- Copy
.env.exampleto.env - Fill in your API keys for each agent's LLM
- Copy
-
Start the Backend:
npm run dev
-
Start the Web UI (Next.js):
cd ui npm run dev
Access the web interface at http://localhost:3000
# Interactive chat with CEO
npx org-agents chat
# Create a new task
npx org-agents task create "Launch new feature"
# List all tasks
npx org-agents task list
# Delegate a task to an agent
npx org-agents delegate --task <id> --agent CFO┌─────────────────────────────────────────────────────────────┐
│ Web UI (Next.js 14) │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────┐ │
│ │ Chat │ │ Dashboard │ │ Command │ │ Agents │ │
│ │ View │ │ (Tasks) │ │ Center │ │ List │ │
│ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └────┬───┘ │
│ └──────────────┴───────────────┴─────────────┘ │
│ Zustand + Clerk Auth + Socket.io │
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────┴──────────────────────────────────┐
│ Core Agent System (TypeScript) │
│ ┌────────────────────────────────────────────────────────┐│
│ │ Agent Registry (CEO, CFO, CTO, COO) ││
│ │ - Per-agent LLM configuration ││
│ │ - Task delegation and orchestration ││
│ │ - Inter-agent communication ││
│ └──────────────────┬─────────────────────────────────────┘│
└──────────────────────────┬──────────────────────────────────┘
│
┌──────────────────────────┴──────────────────────────────────┐
│ Persistence Layer (SQLite + Beads) │
│ ┌─────────────────────┐ ┌─────────────────────────────┐ │
│ │ SQLite Database │ │ Beads CLI (Git-backed) │ │
│ └─────────────────────┘ └─────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Comprehensive documentation is available in the docs/ directory:
- Implementation Plan - Development roadmap
- Architecture - System design
- Agents - Agent capabilities
- API Documentation - REST API endpoints
- CLI Guide - Command-line usage
- Authentication - Clerk setup
OrgAgents is designed to help founders and business owners by providing:
- Strategic Guidance - AI-powered business strategy and decision-making
- Financial Expertise - Budgeting, forecasting, and funding advice
- Technical Leadership - Technology stack and development guidance
- Operational Excellence - Process optimization and workflow management
- Real-time Collaboration - Watch agents coordinate and communicate
- Multi-Agent Orchestration - CEO delegates to specialized executives
- Multi-LLM Support - Each agent uses its optimal model
- CEO & CFO: Codex 5.2
- CTO: Claude Opus 4.5
- COO: Gemini 3.0
- Real-time Task Tracking - Beads CLI for Git-backed issue tracking
- Web-first Interface - Beautiful Next.js dashboard
- Multi-User Support - Clerk authentication with organizations
- CLI Tools - Command-line interface for power users
See the docs/ directory for guidelines on extending and testing the platform.
MIT License - see LICENSE file for details.