Emdash: Cách mạng hóa AI coding với multi-agent orchestration#

🔀 Multi-Agent Orchestration#

Chạy nhiều agents song song:

• Parallel Execution: Thực thi tasks đồng thời trên nhiều agents
• Isolated Worktrees: Mỗi agent hoạt động trong Git worktree riêng
• Centralized Management: Quản lý tất cả từ một giao diện duy nhất
• Task Distribution: Phân phối công việc hiệu quả

Emdash cho phép:

• Fan out tasks cho multiple agents
• Compartmentalize changes
• Compare approaches từ different agents
• Merge results một cách intelligent

🌳 Git Worktrees Integration#

Git Worktrees là sức mạnh cốt lõi của Emdash:

1. Isolation: Mỗi agent làm việc trong workspace riêng biệt
2. Branch Management: Tự động tạo và quản lý branches
3. Conflict Prevention: Tránh conflicts giữa các agents
4. Easy Merging: Merge changes dễ dàng khi hoàn thành
5. History Tracking: Theo dõi lịch sử changes của từng agent

📊 Comprehensive UI Dashboard#

Emdash cung cấp giao diện web hiện đại với:

• Real-time Monitoring: Theo dõi progress của tất cả agents
• Chat Interface: Tương tác với từng agent riêng biệt
• Diff Viewer: Xem changes từ multiple agents
• PR Management: Tạo Pull Requests trực tiếp từ UI
• Status Tracking: Monitor workspace states (idle, running, completed)

Yêu cầu hệ thống#

• Node.js 22.12.0+
• Git
• Ít nhất một AI CLI provider đã được cài đặt
• GitHub CLI (tùy chọn) cho tính năng PR

Cài đặt nhanh#

1
# macOS Apple Silicon
2
curl -L -o emdash-arm64.dmg https://github.com/generalaction/emdash/releases/latest/download/emdash-arm64.dmg
3

4
# macOS Intel x64
5
curl -L -o emdash-x64.dmg https://github.com/generalaction/emdash/releases/latest/download/emdash-x64.dmg

1
# Clone repository
2
git clone https://github.com/generalaction/emdash.git
3
cd emdash
4

5
# Install dependencies
6
npm install
7

8
# Run development server
9
npm run dev

Cài đặt AI CLI Providers#

1
# Install Codex CLI
2
npm install -g @openai/codex
3
# hoặc
4
brew install codex
5

6
# Authenticate
7
codex

1
# Install Claude CLI
2
npm install -g @anthropic-ai/claude-code
3

4
# Start và login
5
claude
6
# Sau đó sử dụng /login trong CLI

1
# macOS
2
brew install gh
3

4
# Linux
5
sudo apt install gh  # Ubuntu/Debian
6
sudo dnf install gh  # Fedora
7

8
# Windows
9
winget install GitHub.cli
10

11
# Authenticate
12
gh auth login

Cho Individual Developers#

• Parallel Development: Thử multiple approaches cùng lúc
• Code Comparison: So sánh solutions từ different agents
• Faster Iteration: Tăng tốc độ development cycle
• Learning Tool: Học từ different coding styles của AI

Cho Development Teams#

• Task Distribution: Phân chia công việc cho multiple agents
• Code Review: Review changes từ nhiều perspectives
• Experimentation: Test different implementations safely
• Knowledge Sharing: Share agent insights và best practices

Cho Enterprise Projects#

• Scalable Development: Scale development capacity với AI
• Quality Assurance: Multiple agents cross-check code quality
• Risk Mitigation: Isolated changes giảm deployment risks
• Compliance: Track và audit AI-generated code changes

1. Project Setup#

1
# Mở project trong Emdash
2
# Auto-detect Git repository
3
# Initialize worktrees cho các agents

2. Multi-Agent Task Assignment#

1
# Assign cùng task cho multiple agents:
2
# Agent 1: "Implement user authentication with JWT"
3
# Agent 2: "Create authentication system using OAuth"
4
# Agent 3: "Build auth with custom session management"

3. Monitor và Compare#

1
# Real-time monitoring progress
2
# Compare approaches side-by-side
3
# Review code quality và performance

4. Merge và Deploy#

1
# Select best solution hoặc combine approaches
2
# Create PR với selected changes
3
# Deploy với confidence

SQLite Database#

Emdash sử dụng SQLite cho local data persistence:

1
CREATE TABLE projects (
2
  id TEXT PRIMARY KEY,
3
  name TEXT NOT NULL,
4
  path TEXT NOT NULL UNIQUE,
5
  git_remote TEXT,
6
  git_branch TEXT,
7
  github_repository TEXT,
8
  github_connected BOOLEAN DEFAULT 0,
9
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
10
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
11
);

1
CREATE TABLE workspaces (
2
  id TEXT PRIMARY KEY,
3
  project_id TEXT NOT NULL,
4
  name TEXT NOT NULL,
5
  branch TEXT NOT NULL,
6
  path TEXT NOT NULL,
7
  status TEXT DEFAULT 'idle',
8
  agent_id TEXT,
9
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
10
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
11
  FOREIGN KEY (project_id) REFERENCES projects (id) ON DELETE CASCADE
12
);

Data Storage Locations#

• macOS: ~/Library/Application Support/emdash/emdash.db
• Windows: %APPDATA%/emdash/emdash.db
• Linux: ~/.config/emdash/emdash.db

GitHub Integration#

• PR Creation: Tạo Pull Requests trực tiếp từ UI
• Branch Management: Auto-create và manage branches
• Repository Info: Display repo badges và stats
• Issue Tracking: Link với GitHub issues

Advanced Git Operations#

1
# Automatic worktree management
2
git worktree add ../agent-1-workspace branch-agent-1
3
git worktree add ../agent-2-workspace branch-agent-2
4

5
# Smart merging strategies
6
git merge --strategy=recursive --strategy-option=theirs

Multi-Provider Support#

1
// Provider switching trong UI
2
const providers = [
3
  'codex',
4
  'claude-code',
5
  'cursor',
6
  'copilot',
7
  'gemini',
8
  'droid',
9
  'amp-code',
10
  'charm'
11
];

Resource Management#

• Memory Efficient: Lightweight Electron app
• CPU Optimization: Parallel processing không block UI
• Storage Management: Efficient SQLite operations
• Network Optimization: Minimal external calls

Scalability Features#

• Unlimited Agents: Không giới hạn số lượng agents
• Large Repositories: Handle enterprise-scale codebases
• History Management: Efficient conversation storage
• Backup và Restore: Database migration support

Data Protection#

• Local-First: Tất cả data stored locally
• No Code Upload: Code không được gửi lên servers
• Encrypted Storage: SQLite data encryption
• Secure Communication: HTTPS cho external APIs

Privacy Controls#

1
# Disable telemetry
2
TELEMETRY_ENABLED=false
3

4
# Clear local data
5
rm -f "$HOME/Library/Application Support/emdash/emdash.db"

Third-Party Integration Security#

• Provider Authentication: Secure token management
• API Rate Limiting: Protect against abuse
• Permission Management: Granular access controls

Agent Connection Issues#

1
# Check provider authentication
2
codex --version
3
claude --version
4

5
# Reset authentication
6
codex logout && codex login

Git Worktree Problems#

1
# List all worktrees
2
git worktree list
3

4
# Clean up orphaned worktrees
5
git worktree prune
6

7
# Remove specific worktree
8
git worktree remove path/to/worktree

Database Issues#

1
# Reset database (quit app first)
2
rm -f "$HOME/Library/Application Support/emdash/emdash.db"
3

4
# Check database integrity
5
sqlite3 emdash.db "PRAGMA integrity_check;"

Planned Features#

• Additional Providers: Support cho more AI coding tools
• Workspace Lifecycle Hooks: Custom scripts cho create/run/archive
• Planning Chat: Controlled execution với draft actions
• Linear Integration: Track và close issues
• Simultaneous Provider Comparison: Compare results realtime

Community Requests#

• Team Collaboration: Multi-user workspaces
• Cloud Sync: Sync settings across devices
• Plugin System: Custom provider plugins
• Advanced Analytics: Detailed performance metrics

Effective Multi-Agent Usage#

1
# 1. Assign complementary tasks
2
Agent 1: "Focus on performance optimization"
3
Agent 2: "Prioritize code readability"
4
Agent 3: "Emphasize security best practices"
5

6
# 2. Use descriptive branch names
7
git checkout -b agent-1-performance-optimization
8
git checkout -b agent-2-readable-implementation
9
git checkout -b agent-3-secure-solution
10

11
# 3. Regular reviews
12
# Check progress every 15-30 minutes
13
# Compare intermediate results
14
# Adjust agent instructions as needed

Active Community#

• Discord Server: 443 stars và growing community
• GitHub Discussions: Active issue tracking và feature requests
• Twitter/X: @emdashsh cho updates
• Contributing: Open source với MIT license

Integration Ecosystem#

• VS Code Extension: Planned integration
• CLI Tools: Command line interface
• API Access: REST API cho automation
• Webhook Support: Integration với CI/CD