​
Monorepo Command

Clone ElizaOS monorepo from a specific branch, defaults to develop.

​
Usage

elizaos monorepo [options]

​
Options

OptionDescriptionDefault
-b, --branch <branch>Branch to clonedevelop
-d, --dir <directory>Destination directory./eliza

​
How It Works

  1. Checks Destination: Verifies the target directory is empty or doesn’t exist
  2. Clones Repository: Downloads the elizaOS/eliza repository from GitHub
  3. Shows Next Steps: Displays instructions for getting started

​
Examples

​
Basic Usage

# Clone default branch (develop) to default directory (./eliza)
elizaos monorepo

# Clone with verbose output
elizaos monorepo --dir ./eliza --branch develop

​
Custom Branch

# Clone main branch
elizaos monorepo --branch main

# Clone feature branch for testing
elizaos monorepo --branch feature/new-api

# Clone release branch
elizaos monorepo --branch v2.1.0

​
Custom Directory

# Clone to custom directory
elizaos monorepo --dir my-eliza-dev

# Clone to current directory (must be empty)
elizaos monorepo --dir .

# Clone to nested path
elizaos monorepo --dir ./projects/eliza-fork

​
Development Workflows

# For contribution development
elizaos monorepo --branch main --dir ./eliza-contrib

# For stable development
elizaos monorepo --branch main --dir ./eliza-stable

# For testing specific features
elizaos monorepo --branch feature/new-plugin-system

​
After Setup

Once cloned, follow these steps:

cd eliza                           # Navigate to the cloned directory
bun i && bun run build            # Install dependencies and build

​
Development Commands

# Start development server
bun run dev

# Run tests
bun test

# Build all packages
bun run build

# Start a specific package
cd packages/client-web
bun dev

​
Monorepo Structure

The cloned repository includes:

eliza/
├── packages/
│   ├── core/              # Core ElizaOS functionality
│   ├── client-web/        # Web interface
│   ├── client-discord/    # Discord client
│   ├── plugin-*/          # Various plugins
│   └── cli/              # CLI tool source
├── docs/                 # Documentation
├── examples/             # Example projects
└── scripts/              # Build and utility scripts

​
Use Cases

​
Contributors

Perfect for developers wanting to:

  • Submit pull requests
  • Develop new plugins
  • Fix bugs or add features
  • Understand the codebase

​
Advanced Users

Useful for users who need:

  • Custom builds
  • Experimental features
  • Local plugin development
  • Integration testing

​
Plugin Developers

Essential for:

  • Plugin development and testing
  • Understanding plugin APIs
  • Contributing to core functionality

​
Troubleshooting

​
Clone Failures

# If git clone fails, check network connection
git --version
ping github.com

# For authentication issues
git config --global credential.helper store

​
Directory Issues

# If directory is not empty
ls -la ./eliza              # Check contents
rm -rf ./eliza              # Remove if safe
elizaos monorepo            # Retry

# For permission issues
sudo chown -R $USER:$USER ./eliza

​
Build Failures

# If dependencies fail to install
cd eliza
rm -rf node_modules
bun install

# If build fails
bun run clean
bun install
bun run build

​
Branch Not Found

# List available branches
git ls-remote --heads https://github.com/elizaOS/eliza

# Use correct branch name
elizaos monorepo --branch main

​
Notes

  • The destination directory must be empty or non-existent
  • Uses the official elizaOS/eliza repository from GitHub
  • Requires Git to be installed on your system
  • Internet connection required for cloning
  • create: Create a new project or plugin from templates
  • plugins: Manage plugins in your project
  • dev: Run development server for your projects