juleson (Samy Rai)

Juleson

](https://golang.org/)   

具有全面自动化功能的AI驱动编码代理

与谷歌Jules AI编码代理集成的生产就绪AI代理系统 通过CLI和MCP（模型上下文协议）接口。具有智能 具有代码审查、学习功能和高级自动化工作流的代理架构。

🎯 概述

Juleson将您的开发工作流程与谷歌的Jules AI代理连接起来，提供：

• 🤖 智能AI代理：具有感知、规划、行动、审查和反思周期的完整代理架构
• 🔍 高级代码智能：使用调用图、复杂性度量和符号引用进行深度代码库分析
• � 学习系统：Agent从记忆、反馈循环和自适应行为的经验中学习
• 🎯 代码审查自动化：内置代码审查器，具有安全检查和质量验证功能
• 📋 模板系统：12个内置的自动化模板，用于重构、测试和文档编制
• 💬 会话管理：通过智能审批工作流完全控制Jules编码会话
• 🔌 MCP集成：用于AI助手的本地模型上下文协议服务器（Claude、Cursor等）
• 🐙 GitHub集成：存储库管理、PR工作流和git感知会话创建
• ⚙️ CLI工具：具有20多个命令的综合命令行界面
• 📡 事件系统：具有持久性和监控功能的实时事件驱动架构
• 🎨 AI编排：具有依赖关系管理和Gemini集成的多步工作流执行

🏗️ 建筑

Juleson/
├── cmd/                          # Application entry points
│   ├── juleson/                 # CLI tool for direct usage
│   ├── juleson-mcp/             # MCP server for AI assistants
│   └── orchestrator/            # Build orchestrator
├── internal/
│   ├── agent/                   # 🤖 Intelligent AI Agent System
│   │   ├── core/                # Agent loop (perceive→plan→act→review→reflect)
│   │   ├── github/              # GitHub integration for agents
│   │   ├── memory/              # Learning and memory system
│   │   ├── review/              # Code review automation
│   │   ├── tools/               # Tool registry and implementations
│   │   └── types.go             # Agent state and goal definitions
│   ├── analyzer/                # 🔍 Advanced Code Intelligence
│   │   ├── analyzer.go          # Project analysis engine
│   │   ├── quality.go           # Code quality assessment
│   │   └── analyzer_test.go     # Test coverage analysis
│   ├── automation/              # 🎨 AI Orchestration Engine
│   │   ├── ai_orchestrator.go   # Multi-step workflow orchestration
│   │   ├── engine.go            # Task execution & dependency management
│   │   └── engine_test.go       # Orchestration testing
│   ├── cli/                     # ⚙️ CLI Implementation (20+ commands)
│   │   ├── app.go               # Main CLI application
│   │   └── commands/            # Command implementations
│   │       ├── actions.go       # Action management
│   │       ├── activities.go    # Activity monitoring
│   │       ├── agent.go         # 🤖 Agent commands
│   │       ├── ai_orchestrate.go # 🎨 AI orchestration
│   │       ├── analyze.go       # 🔍 Analysis commands
│   │       ├── completion.go    # Shell completion
│   │       ├── dev.go           # Development tools
│   │       ├── display.go       # Display utilities
│   │       ├── execute.go       # Template execution
│   │       ├── github.go        # 🐙 GitHub integration
│   │       ├── orchestrate.go   # Workflow orchestration
│   │       ├── pr.go            # Pull request management
│   │       ├── sessions.go      # 💬 Session management
│   │       ├── setup.go         # Initial setup
│   │       ├── sources.go       # Source management
│   │       ├── sync.go          # Project synchronization
│   │       ├── template.go      # 📋 Template management
│   │       └── version.go       # Version information
│   ├── codeintel/               # 🔍 Code Intelligence Engine
│   │   ├── context/             # Code context analysis
│   │   ├── graph/               # Call graph building
│   │   ├── static/              # Static analysis runner
│   │   └── types.go             # Code intelligence types
│   ├── config/                  # Configuration management
│   │   └── config.go            # YAML + environment variables
│   ├── events/                  # 📡 Event-Driven Architecture
│   │   ├── bus.go               # Pub/sub event bus
│   │   ├── circuit_breaker.go   # Fault tolerance
│   │   ├── coordinator.go       # Event coordination
│   │   ├── doc.go               # Event documentation
│   │   ├── middleware.go        # Event processing middleware
│   │   ├── queue.go             # Message queues
│   │   ├── store.go             # Event persistence
│   │   └── types.go             # Event definitions
│   ├── gemini/                  # 🎨 Gemini AI Integration
│   │   └── client.go            # Gemini API client
│   ├── github/                  # 🐙 GitHub API Integration
│   │   ├── actions.go           # GitHub Actions
│   │   ├── client.go            # GitHub API client
│   │   ├── git.go               # Git operations
│   │   ├── issues.go            # Issue management
│   │   ├── milestones.go        # Milestone management
│   │   ├── projects.go          # Project management
│   │   ├── pullrequests.go      # PR management
│   │   ├── repositories.go      # Repository operations
│   │   ├── sessions.go          # Session integration
│   │   ├── types.go             # GitHub types
│   │   └── utils.go             # Utility functions
│   ├── jules/                   # Jules API Integration
│   │   ├── client.go            # HTTP client & retry logic
│   │   ├── sessions.go          # Session management (CRUD)
│   │   ├── activities.go        # Activity monitoring
│   │   ├── artifacts.go         # Artifact handling
│   │   └── monitor.go           # Real-time session monitoring
│   ├── mcp/                     # 🔌 MCP Server Implementation
│   │   ├── server.go            # Official SDK integration
│   │   └── tools/               # MCP tool implementations
│   │       ├── codeintel.go     # 🔍 Code intelligence tools
│   │       ├── docker.go        # Docker management tools
│   │       ├── gemini.go        # 🎨 Gemini AI tools
│   │       ├── github.go        # 🐙 GitHub tools
│   │       └── orchestrator.go  # 🎨 Orchestration tools
│   ├── orchestrator/            # Build Orchestration
│   │   ├── build.go             # Build orchestration
│   │   ├── deps.go              # Dependency management
│   │   ├── docker.go            # Docker operations
│   │   ├── quality.go           # Quality checks
│   │   ├── run.go               # Execution orchestration
│   │   └── test.go              # Test orchestration
│   ├── presentation/            # Display & Formatting
│   ├── services/                # Service Container & DI
│   │   └── container.go         # Application services
│   └── templates/               # 📋 Template Management
│       └── manager.go           # Template CRUD & validation
├── docs/                        # 📚 Comprehensive Documentation
│   ├── AGENT_ARCHITECTURE.md
│   ├── AGENT_ARCHITECTURE_CODE_REVIEW.md
│   ├── AGENT_PRODUCTION_FEATURES.md
│   ├── AI_ORCHESTRATION.md
│   ├── CLI_REFERENCE.md
│   ├── CODE_INTELLIGENCE.md
│   ├── DEPLOYMENT_GUIDE.md
│   ├── DX_IMPROVEMENTS.md
│   ├── EVENT_SYSTEM_ARCHITECTURE.md
│   ├── EVENT_SYSTEM_QUICKSTART.md
│   ├── GITHUB_ACTIONS_GUIDE.md
│   ├── GITHUB_CONFIGURATION_GUIDE.md
│   ├── GITHUB_INTEGRATION_PROPOSAL.md
│   ├── INSTALLATION_GUIDE.md
│   ├── MCP_SERVER_USAGE.md
│   ├── ORCHESTRATOR_ARCHITECTURE.md
│   ├── README.md
│   ├── SETUP_GUIDE.md
│   └── docs/
├── templates/                   # 📋 Automation Templates
│   ├── builtin/                # 12 production templates
│   │   ├── reorganization/     # Architecture refactoring
│   │   ├── testing/            # Test generation
│   │   ├── refactoring/        # Code improvement
│   │   └── documentation/      # Doc generation
│   ├── custom/                 # User-defined templates
│   └── registry/               # Template metadata
├── configs/                     # Configuration files
│   └── Juleson.yaml            # Default configuration
├── scripts/                     # Demo scripts
│   ├── ai_parsing_demo_only.go
│   └── session_orchestrator_poc.go
└── docker-compose.yml           # 🐳 Development environment

✨ 特性

🤖 智能人工智能代理系统

• ✅ 代理体系结构：完整的代理循环（感知→ plan → act → 审查→ 反映）
• ✅ 状态管理：闲置、分析、规划、执行、审查、反映状态
• ✅ 目标导向的：具有约束、优先级和截止日期的结构化目标
• ✅ 存储器系统：从持久记忆的经验中学习
• ✅ 工具注册表：26多种用于代码分析、GitHub、Docker和AI操作的工具
• ✅ 代码审查：具有安全检查和质量验证功能的自动代码审查器
• ✅ 适应性行为：从结果中学习并调整未来的行动

🔍 高级代码智能

• ✅ 项目分析：通过语言/框架检测进行深度代码库检查
• ✅ 调用图分析：使用循环检测构建和分析调用图
• ✅ 符号参考：查找整个项目中所有符号的引用
• ✅ 复杂性度量：计算圈复杂度和认知复杂度
• ✅ 静态分析：运行全面的静态分析检查
• ✅ 代码上下文：提取符号、导入和结构信息

🎨 AI驱动的编排

• ✅ 多步骤工作流：具有依赖关系管理的复杂工作流执行
• ✅ Gemini集成：人工智能驱动的项目分析和规划
• ✅ 模板编排：使用自定义参数执行自动化模板
• ✅ GitHub项目管理：自然语言GitHub操作（问题、里程碑、项目）
• ✅ 会话综合：Jules会话分析，具有可操作的见解

Jules API集成

• ✅ Jules API v1alpha全面支持
• ✅ 会话管理（创建、获取、列出、批准、发送消息）
• ✅ 使用分页进行活动和工件监控
• ✅ 对大型数据集的分页支持
• ✅ 指数回退自动重试
• ✅ 全面的错误处理
• ✅ 来自会话的Git补丁应用程序

备注：会话取消/删除在API中不可用-使用 Jules网页用户界面

🐙 GitHub集成

• ✅ 库管理：列出、分析和管理存储库
• ✅ 拉取请求操作：创建、列出、合并和管理PR
• ✅ 问题管理：创建、更新和跟踪问题
• ✅ 项目管理：里程碑、项目和工作流自动化
• ✅ Git感知会话：从GitHub上下文创建Jules会话
• ✅ CI/CD集成：GitHub Actions工作流和自动化

📋 模板系统

12个内置模板 分为4类：

🔌 MCP服务器（19个工具）

• ✅ 官方模型上下文协议（MCP）Go SDK
• ✅ Stdio传输（与克劳德桌面、光标兼容）
• ✅ 项目分析：深度项目分析和Git同步
• ✅ 代码智能：图形分析、符号引用、复杂性度量
• ✅ 模板管理：执行、列出、搜索和创建模板
• ✅ 会话控制：列出、批准、预览和应用会话更改
• ✅ 开发工具：构建、测试、裁剪、格式化和质量检查
• ✅ Docker管理：容器操作和编排
• ✅ AI编排：工作流程规划和执行

📡 事件驱动架构

• ✅ 事件总线：具有基于主题的路由和中间件的发布/子系统
• ✅ 消息队列：具有优先级的异步任务处理
• ✅ 事件存储：审计跟踪和回放功能的事件持久性
• ✅ 断路器：外部API调用的容错
• ✅ 自动事件发射：所有Jules API调用都会发出结构化事件
• ✅ 事件监控：实时日志记录、指标和错误聚合

⚙️ CLI工具（20+命令）

• ✅ 代理命令: agent -控制AI代理操作
• ✅ 分析命令: analyze, ai-orchestrate -项目和人工智能分析
• ✅ 会话管理: sessions, activities -Jules会话控制
• ✅ 模板操作: template, execute -模板管理
• ✅ GitHub集成: github, pr -存储库和PR管理
• ✅ 开发工具: dev, setup -开发工作流程
• ✅ 编排: orchestrate, actions -工作流管理

� 快速开始

先决条件

• 达到1.24或更高
• Jules API密钥(从Google获取一个)
• Git（用于项目分析功能）
• 可选：Gemini API键（用于AI编排功能）
• 可选：GitHub令牌（用于GitHub集成功能）

安装

📚 有关所有平台的详细安装说明，请参阅 docs/INSTALLION_GUIDE.md

快速安装

Linux/macOS：

# Using Go (requires Go 1.24+)
go install github.com/SamyRai/juleson/cmd/juleson@latest
go install github.com/SamyRai/juleson/cmd/juleson-mcp@latest

窗户：

# Using Go (requires Go 1.24+)
go install github.com/SamyRai/juleson/cmd/juleson@latest
go install github.com/SamyRai/juleson/cmd/juleson-mcp@latest

从源代码构建

# Clone the repository
git clone https://github.com/SamyRai/juleson.git
cd juleson

# Install dependencies
go mod download

# Configure your API key
export JULES_API_KEY="your-jules-api-key-here"

# Optional: Configure Gemini and GitHub
export GEMINI_API_KEY="your-gemini-api-key"  # For AI orchestration
export GITHUB_TOKEN="ghp_your_github_token"  # For GitHub integration

# Build the orchestrator first
go build -o bin/orchestrator ./cmd/orchestrator

# Build binaries using orchestrator
./bin/orchestrator build

# Install to system
./bin/juleson dev install

# Verify installation
juleson --version
juleson-mcp --version

📖 用法

快速开始

# First-time setup (recommended)
juleson setup

# Or configure manually
export JULES_API_KEY="your-jules-api-key"
export GITHUB_TOKEN="ghp_your_github_token"  # Optional, for GitHub integration

# Verify setup
juleson github status
juleson sessions list

CLI命令

有关完整的命令参考，请参见 docs/CLI_REFERENCE.md

常用命令：

# First-time setup (recommended)
juleson setup

# 🤖 Agent Commands
juleson agent run "analyze and refactor this codebase"  # Run AI agent
juleson agent status                                    # Check agent status
juleson agent memory                                    # View agent memory

# 🔍 Analysis Commands
juleson analyze ./my-project                            # Analyze project structure
juleson ai-orchestrate plan ./my-project                # AI-powered project planning

# 📋 Template Operations
juleson template list                                   # List available templates
juleson template list reorganization                     # Filter by category
juleson execute template modular-restructure ./my-project # Execute template

# 💬 Session Management
juleson sessions list                                   # List all Jules sessions
juleson sessions status                                 # Show session summary
juleson sessions approve session-123                     # Approve session plan
juleson sessions apply session-123 ./my-project         # Apply session patches

# 🐙 GitHub Integration
juleson github repos                                    # List your repositories
juleson github current                                  # Show current repo
juleson pr list                                         # List pull requests
juleson pr merge session-123                            # Merge a PR

# 🎨 AI Orchestration
juleson orchestrate workflow "refactor-monolith" ./my-project # Multi-step workflow
juleson actions list                                     # List available actions

# 🔧 Development Tools
juleson dev build                                       # Build project
juleson dev test                                        # Run tests
juleson dev quality                                     # Run quality checks

# Search and Utilities
juleson template search "test coverage"                 # Search templates
juleson template create my-template refactoring "Description" # Create custom template

MCP服务器使用情况

启动MCP服务器以与AI助手集成：

./bin/juleson-mcp

使用Claude Desktop进行配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "Juleson": {
      "command": "/absolute/path/to/Juleson/bin/juleson-mcp",
      "env": {
        "JULES_API_KEY": "your-api-key"
      }
    }
  }
}

使用游标配置

添加到游标设置JSON：

{
  "mcp.servers": {
    "Juleson": {
      "command": "/absolute/path/to/Juleson/bin/juleson-mcp",
      "env": {
        "JULES_API_KEY": "your-api-key"
      }
    }
  }
}

可用的MCP工具

备注: cancel_session 和 delete_session 在Jules API中不可用 v1alpha。使用 Jules网页用户界面 对于这些操作。

看 MCP_SERVER_USAGE.md API的详细文档。

💡 例子

示例1：分析和重构Go项目

# Analyze project
./bin/juleson analyze ./my-go-app

# List reorganization templates
./bin/juleson template list reorganization

# Execute modular restructure template
./bin/juleson execute template modular-restructure ./my-go-app

示例2：生成低覆盖率测试

# Execute test generation template
./bin/juleson execute template test-generation ./my-project

# Or improve existing coverage
./bin/juleson execute template test-coverage-improvement ./my-project

示例3：会话管理工作流

# List all active sessions
./bin/juleson sessions list

# Get status summary
./bin/juleson sessions status

# Monitor a specific session (via Jules API)
# The session ID will be in the execute template output

示例4：在Claude中使用MCP服务器

使用MCP服务器配置Claude Desktop后：

提示克劳德：

“使用Juleson在/path/to/我的项目中分析我的项目，并提出建议 适当的重构模板”

Claude将使用MCP工具：

1. 呼叫 analyze_project 了解你的代码库
2. 呼叫 list_templates 查找相关模板
3. 根据分析建议最佳模板
4. （可选）使用以下命令执行模板 execute_template

示例5：应用Jules会话补丁

# Preview what changes a Jules session would make (dry-run)
./bin/juleson sessions preview session-123 ./my-project

# Apply patches from Jules session to your project
./bin/juleson sessions apply session-123 ./my-project

# Apply with backup files (creates .backup files before modifying)
./bin/juleson sessions apply session-123 ./my-project --backup

与Claude一起使用MCP：

“从Jules会话会话-123获取更改并将其应用于我的项目”

克劳德将：

1. 呼叫 preview_session_changes 向您展示将要修改的内容
2. 呼叫 apply_session_patches 应用git补丁
3. 报告哪些文件被修改

示例6：创建自定义模板

# Create a custom template
./bin/juleson template create api-versioning refactoring \
  "Add API versioning to existing REST endpoints"

# Edit the generated template file
# templates/custom/refactoring/api-versioning.yaml

# Execute your custom template
./bin/juleson execute template api-versioning ./my-api-project

示例8:AI代理自动化

# Run an intelligent agent to analyze and improve your codebase
juleson agent run "analyze this Go project and suggest refactoring improvements"

# Check agent status and progress
juleson agent status

# View agent's learned patterns and decisions
juleson agent memory

# Use AI orchestration for complex multi-step tasks
juleson ai-orchestrate plan ./my-project
juleson orchestrate workflow "comprehensive-refactor" ./my-project

示例9：高级代码智能

# Analyze code complexity and quality metrics
juleson analyze complexity ./my-project

# Find all references to a specific function
juleson analyze references "func ProcessData" ./my-project

# Build and analyze call graphs
juleson analyze graph ./my-project

# Run comprehensive static analysis
juleson analyze static ./my-project

配置文件

创建 configs/Juleson.yaml:

jules:
  api_key: ""  # Or use JULES_API_KEY environment variable
  base_url: "https://jules.googleapis.com/v1alpha"
  timeout: "30s"
  retry_attempts: 3

mcp:
  server:
    port: 8080
    host: "localhost"
  client:
    timeout: "10s"

automation:
  strategies:
    - "modular"
    - "layered"
    - "microservices"
  max_concurrent_tasks: 5
  task_timeout: "300s"

projects:
  default_path: "./projects"
  backup_enabled: true
  git_integration: true

环境变量

# Required
export JULES_API_KEY="your-jules-api-key"

# Optional (with defaults)
export JULES_BASE_URL="https://jules.googleapis.com/v1alpha"
export JULES_TIMEOUT="30s"
export JULES_RETRY_ATTEMPTS="3"

看 configs/Juleson.example.yaml 完全 配置选项。

🧪 发展

运行测试

# Build orchestrator first
go build -o bin/orchestrator ./cmd/orchestrator

# Run all tests
./bin/orchestrator test

# Run with coverage
./bin/orchestrator coverage

# Run specific package tests
go test -v ./internal/jules/...
go test -v ./internal/mcp/...

# Short tests only (exclude integration tests)
./bin/orchestrator test-short

代码质量

# Format code
./bin/orchestrator fmt

# Run linters
./bin/orchestrator lint

# Run all checks (fmt + lint + test)
./bin/orchestrator check

建筑

# Build both binaries
./bin/orchestrator build

# Build CLI only
./bin/orchestrator build-cli

# Build MCP server only
./bin/orchestrator build-mcp

# Install to $GOPATH/bin
./bin/orchestrator install

项目统计

• 测试覆盖率：代理系统26%，核心包80%+
• 代码行：~29360（不包括测试和文档）
• Go套餐：15+内部包装
• CLI命令：4个类别的20多个命令
• MCP工具：19个AI助手工具
• 内置模板：12个生产模板
• 代理工具：26多种智能自动化工具
• 依赖项：现代Go生态系统（MCP SDK、Google API、GitHub API）

� api参考

Jules客户API

// Create a Jules client
client := jules.NewClient(apiKey, baseURL, timeout, retryAttempts)

// Session management
session, err := client.CreateSession(ctx, &jules.CreateSessionRequest{
    Prompt: "Refactor this project to use clean architecture",
    Title:  "Architecture Refactoring",
    SourceContext: &jules.SourceContext{Source: "./my-project"},
})

// List sessions with pagination
response, err := client.ListSessionsWithPagination(ctx, 50, "")

// Get session details
session, err := client.GetSession(ctx, sessionID)

// Approve session plan
err := client.ApprovePlan(ctx, sessionID)

// Send message to session
err := client.SendMessage(ctx, sessionID, "Please add error handling")

// Apply patches from session to working directory
result, err := client.ApplySessionPatches(ctx, sessionID, &jules.PatchApplicationOptions{
    WorkingDir:   "./my-project",
    DryRun:       false,
    CreateBackup: true,
})

// Preview session changes (dry-run)
changes, err := client.PreviewSessionPatches(ctx, sessionID, "./my-project")

// Get session changes summary
changes, err := client.GetSessionChanges(ctx, sessionID)

// Activity monitoring
activities, err := client.ListActivities(ctx, sessionID, 100)

自动化引擎API

// Create automation engine
engine := automation.NewEngine(julesClient, templateManager)

// Analyze project
context, err := engine.AnalyzeProject("./my-project")

// Execute template
result, err := engine.ExecuteTemplate(ctx, "modular-restructure", map[string]string{
    "target_architecture": "clean",
    "preserve_tests": "true",
})

模板管理器API

// Create template manager
manager, err := templates.NewManager("./templates")

// Load template
template, err := manager.LoadTemplate("modular-restructure")

// List all templates
templates := manager.ListTemplates()

// Search templates
results := manager.SearchTemplates("test coverage")

// Create custom template
template, err := manager.CreateTemplate("my-template", "refactoring", "Description")

🚀 路线图

✅ v0.1.0-人工智能代理基础 （2025年11月竣工）

• ✅ 智能AI代理：具有状态管理的完整代理架构
• ✅ 学习系统：适应性行为的记忆和反馈回路
• ✅ 代码审查自动化：带有安全检查的内置审查器
• ✅ 高级代码智能：调用图、复杂性分析、符号引用
• ✅ AI编排：通过Gemini集成执行多步工作流
• ✅ 全面的CLI：跨代理、分析和编排的20多个命令
• ✅ MCP集成：19个AI助手工具（Claude、Cursor）
• ✅ GitHub集成：存储库管理和PR工作流程
• ✅ 事件驱动架构：实时监控和持久性
• ✅ Docker管理：容器操作和编排

🔄 v0.2.0-增强智能 （2026年第一季度）

• 🔄 进阶学习：模式识别和预测建议
• 🔄 性能分析：运行时分析和优化建议
• 🔄 证券分析：自动漏洞检测和修复
• 🔄 多语言支持：扩展到Go之外（Python、JavaScript等）

📋 v0.3.0-企业功能 （2026年第二季度）

• 📋 团队协作：共享代理内存和项目见解
• 📋 Web仪表板：可视化项目管理和代理监控
• 📋 企业安全：SSO、审计跟踪和合规性功能
• 📋 工作流模板：预构建的企业自动化工作流程

🌟 v1.0.0-生产平台 （2026年第3季度）

• 🌟 可扩展体系结构：多租户部署和高可用性
• 🌟 高级AI模型：与最新的AI模型和API集成
• 🌟 综合模板库：100多个生产就绪模板
• 🌟 SLA监控：性能保证和正常运行时间监控

🤝 贡献

我们欢迎捐款！请看 贡献.md 了解详情。

快速贡献指南

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 通过测试进行更改
4. 进行质量检查(./bin/orchestrator check)
5. 提交您的更改(git commit -m 'feat: add amazing feature')
6. 推你的叉子(git push origin feature/amazing-feature)
7. 打开拉取请求

开发设置

# Clone your fork
git clone https://github.com/SamyRai/Juleson.git
cd Juleson

# Install dependencies
go mod download

# Build orchestrator
go build -o bin/orchestrator ./cmd/orchestrator

# Run tests
./bin/orchestrator test

# Build
./bin/orchestrator build

代码规范

• 跟随 有效Go 指南
• 对新代码保持>80%的测试覆盖率
• 使用常规提交(feat:, fix:, docs:, test:, refactor:)
• 为导出的函数添加godoc注释
• 跑 ./bin/orchestrator fmt 和 ./bin/orchestrator lint 在提交之前

� 许可证

该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。

Copyright (c) 2025 Juleson Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...

🔗 资源

• 文档: docs/

- 安装指南 -首次设置和配置 - CLI参考 -完整的命令行参考 - MCP服务器使用指南 -MCP集成 - 代码智能 -高级代码分析功能 - 事件系统快速入门 -事件驱动架构 - 事件系统架构 -活动系统设计 - -GitHub设置 - 安装指南 -平台特定安装 - 模板系统文档 -模板创建 - -CI/CD设置

• Jules API: Google Jules API文档
• MCP协议: 模型上下文协议规范
• 官方MCP Go SDK:

📊 项目状态

• 当前版本：0.1.0（阿尔法）
• 代理系统: ✅ 完成（70%实施）
• 核心功能: ✅ 生产就绪（使用API密钥）
• 测试覆盖率：26%代理系统，80%+核心包
• CI/CD：已配置GitHub操作
• 文档：15+综合指南
• 稳定性：API稳定，开发积极
• 建筑：事件驱动，使用全面的工具

⚠️ 已知限制

• Jules API访问需要获得Google批准的API密钥
• MCP服务器需要stdio传输（还没有HTTP/WebSocket）
• 模板执行需要活动的互联网连接
• 大型项目（>10k文件）的分析速度可能较慢
• 会话监控是基于轮询的（还没有webhooks）

🆘 支持

• 问题:
• 讨论:
• 安全：参见 安全.md
• 更新日志：参见 更改日志.md

🙏 致谢

• Google Jules团队为令人惊叹的AI编码代理
• 优秀Go SDK的模型上下文协议团队
• 眼镜蛇 用于CLI框架
• 蝰蛇 用于配置管理
• 所有帮助改进此项目的贡献者

______________________________________________________________________

👥 社区

由以下材料制成❤️ Juleson社区

*星⭐ 如果你觉得这个仓库有用的话！*