convez.ai
Agente
tleub-ebp

WorkPilot-AI

tleub-ebp/WorkPilot-AI

Ver no GitHub
BomPluginScore · de 0 a 100

Autonomous multi-agent coding framework that plans, builds, validates and document software for you

Instalação

$npx convez-ai tleub-ebp/WorkPilot-AI

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 3 dias
Versão
1.0.0
Issues abertas
27
Contribuidores
28

README

A tradução para o português deste README ainda está na fila.

WorkPilot AI

Autonomous multi-agent coding framework that plans, builds, and validates software for you.

WorkPilot AI Kanban Board

License Discord YouTube CI


Download

Stable Release

Stable

PlatformDownload
WindowsWorkPilot-AI-1.0.0-win32-x64.exe
macOS (Apple Silicon)WorkPilot-AI-1.0.0-darwin-arm64.dmg
macOS (Intel)WorkPilot-AI-1.0.0-darwin-x64.dmg
LinuxWorkPilot-AI-1.0.0-linux-x86_64.AppImage
Linux (Debian)WorkPilot-AI-1.0.0-linux-amd64.deb
Linux (Flatpak)WorkPilot-AI-1.0.0-linux-x86_64.flatpak

Beta Release

Beta releases may contain bugs and breaking changes. View all releases

Beta

PlatformDownload
WindowsWorkPilot-AI-1.0.0-alpha.1-win32-x64.exe
macOS (Apple Silicon)WorkPilot-AI-1.0.0-alpha.1-darwin-arm64.dmg
macOS (Intel)WorkPilot-AI-1.0.0-alpha.1-darwin-x64.dmg
LinuxWorkPilot-AI-1.0.0-alpha.1-linux-x86_64.AppImage
Linux (Debian)WorkPilot-AI-1.0.0-alpha.1-linux-amd64.deb
Linux (Flatpak)WorkPilot-AI-1.0.0-alpha.1-linux-x86_64.flatpak

All releases include SHA256 checksums and VirusTotal scan results for security verification.


Quick Start

  1. Download and install the app for your platform
  2. Open your project — select a git repository folder
  3. Connect your AI provider — Claude (OAuth), API key, or any OpenAI-compatible endpoint
  4. Create a task — describe what you want to build
  5. Watch it work — agents plan, code, and validate autonomously

Or from source:

pnpm install
pnpm run dev

See the Setup Guide for detailed instructions.


Features

Autonomous Development Pipeline

FeatureDescription
Kanban BoardVisual task management from planning through completion with real-time agent progress
Multi-Agent PipelinePlanner → Coder → QA Reviewer → QA Fixer pipeline runs autonomously end-to-end
Parallel ExecutionUp to 12 simultaneous agent terminals for parallel builds
Isolated WorkspacesEvery task runs in a dedicated git worktree — your main branch stays safe
AI-Powered MergeSemantic conflict resolution when integrating worktrees back to main
QA Auto-Fix LoopAgents automatically detect, fix, and revalidate failing acceptance criteria
Spec Approval WorkflowReview and approve AI-generated specifications before implementation begins

Multi-Agent Orchestration

FeatureDescription
Mission ControlNASA-style dashboard for orchestrating multiple agents simultaneously — live status, token consumption, file changes, and per-agent reasoning
Agent Replay & DebugStep-by-step replay of any agent session with timeline navigation, file diffs, breakpoints, and token heatmaps
Decision LoggerReal-time visualization of agent decision trees and trade-off rationale
Pair ProgrammingInteractive real-time AI coding partner with live suggestions and conversation-driven development
Learning ModeEducational mode with step-by-step explanations of agent decisions

Specialized Agents

AgentRole
PlannerComplexity assessment, phased subtask breakdown, dependency analysis
CoderContext-aware implementation with parallel subagent spawning
QA Reviewer / FixerAcceptance criteria validation and automated issue resolution
Test GeneratorUnit and integration test generation with coverage analysis
RefactorerSafe code refactoring with pattern detection and API migration
DocumenterREADME, API docs, and architecture documentation generation
Migration AgentFramework and library migration with breaking change detection
Memory ManagerGraphiti-based knowledge graph management across sessions

Integrations

PlatformCapabilities
GitHubImport issues, AI investigation, PR review, batch review wizard, auto-PR creation
GitLabIssues and merge request management with AI severity categorization
Azure DevOpsWork item import, PR review, batch operations — experimental: backend still returns mock data for several endpoints, see shared_docs/CONFIGURATION.md
LinearBulk issue import with team/project filtering
JiraIssue management integration
MCP MarketplaceBrowse, install, and configure Model Context Protocol servers
Custom MCPsDefine and host custom MCP servers with local authentication
WindsurfWindsurf IDE integration via Connect protocol

AI Providers & Authentication

ProviderAuth Method
Anthropic ClaudeOAuth (subscription) or API key
OpenAIOAuth (subscription) or API key
Google GeminiAPI key
Grok / xAIAPI key
OllamaLocal endpoint
Azure OpenAIAPI key + endpoint
GitHub CopilotOAuth (subscription) or API key
Custom endpointsAny OpenAI-compatible API (e.g. z.ai for GLM models)

Multi-account switching — Register multiple profiles per provider. WorkPilot AI automatically switches to an available account when one hits a rate limit.

Code Intelligence

FeatureDescription
InsightsAI chat interface for exploring and understanding your codebase with semantic search
IdeationDiscovers performance bottlenecks, security vulnerabilities, code quality issues, and UI/UX improvements
Architecture VisualizerDependency graphs, module hierarchy, and component relationship diagrams
Performance ProfilerAI-powered bottleneck identification with optimization suggestions
Dependency SentinelMonitors security vulnerabilities, version conflicts, and outdated dependencies
Self-Healing CodebaseAutomatically generates fixes when CI tests fail; integrates with Sentry, Datadog, PagerDuty for production incidents
Risk ClassifierScores code changes by risk level with impact assessment

Developer Productivity

FeatureDescription
RoadmapAI-assisted feature planning with prioritization and phased rollout
ChangelogAuto-generates release notes from completed tasks
Natural Language GitAI-generated semantic commit messages from diffs
Auto-RefactoringPattern-based and architectural code transformations
Code MigrationLarge-scale codebase migrations across frameworks and libraries
Design to CodeConverts UI mockups and screenshots to React/HTML
Pipeline GeneratorGenerates GitHub Actions, GitLab CI, and Azure Pipelines configurations
Browser AgentAutonomous browser interaction for E2E test generation and visual regression
Arena ModeSide-by-side comparison of different AI models on the same task
Voice ControlHands-free task and terminal control via speech-to-text
Multi-Repo OrchestrationCoordinate changes across multiple repositories simultaneously
Code PlaygroundSandbox environment for testing code snippets in isolation
Prompt OptimizerAnalyzes and rewrites prompts for better AI output

Memory & Context

FeatureDescription
Memory System (Graphiti)Graph-based semantic memory — agents retain insights across sessions
Skills SystemToken-optimized dynamic skill execution with checkpoint-based context management
Context ManagementIntelligent context building with file relevance ranking and dependency graph analysis
Session HistoryBrowse and replay past agent sessions with full statistics

Analytics & Monitoring

FeatureDescription
Analytics DashboardToken consumption, cost tracking, success rates, and execution time metrics — live SQLite-backed API; falls back to an explicit 503 when the analytics DB is unavailable
Cost EstimatorPer-task cost calculation with provider comparison and budget alerts
Rate Limit MonitorReal-time usage tracking with proactive warnings and auto-switching triggers
Workflow LoggerStructured execution logs with trace IDs for all agents, skills, and hooks

Customization

FeatureDescription
7+ Color ThemesDefault, Dusk, Lime, Ocean, Retro, Neo — each with light and dark variants
Custom Theme EditorColor picker with live preview, export, and import
Bilingual UIFull French and English interface
Command PaletteKeyboard-driven access to all features with fuzzy search
Plugin MarketplaceBrowse and install community plugins

Interface

Kanban Board

Visual task management from planning through completion. Create tasks and monitor agent progress in real-time.

Agent Terminals

AI-powered terminals with one-click task context injection. Spawn multiple agents for parallel work.

Agent Terminals

Mission Control

NASA-style multi-agent orchestration hub with per-agent monitoring, model assignment, and live decision visualization.

Roadmap

AI-assisted feature planning with competitor analysis and audience targeting.

Roadmap

Additional Views

  • Insights — AI chat for codebase exploration and semantic search
  • Ideation — Discover improvements, vulnerabilities, and performance issues
  • Changelog — Generate release notes from completed tasks
  • Architecture Visualizer — Interactive dependency and module graphs
  • Agent Replay — Step-by-step session replay with breakpoints and diffs
  • Analytics — Usage, cost, and performance dashboards

Architecture Détaillée

Vue d'Ensemble

WorkPilot AI est une application de bureau autonome basée sur une architecture multi-agents qui orchestre le cycle de vie complet du développement logiciel. Le système combine un backend Python puissant avec une interface utilisateur Electron moderne pour offrir une expérience de développement transparente.

Architecture Multi-Agents

Pipeline Autonome de Développement

  1. Agent Planner - Analyse la complexité et décompose les tâches en sous-tâches
  2. Agent Coder - Implémente les fonctionnalités avec des sous-agents parallèles
  3. Agent QA Reviewer - Valide les implémentations selon les critères d'acceptation
  4. Agent QA Fixer - Résout automatiquement les problèmes identifiés

Agents Spécialisés

  • Test Generator - Génération de tests unitaires et d'intégration
  • Refactorer - Refactoring sécurisé du code avec détection de patterns
  • Documenter - Génération automatique de documentation
  • Migration Agent - Migration de frameworks et bibliothèques
  • Memory Manager - Gestion de la base de connaissances Graphiti

Architecture Technique

Backend Python (apps/backend/)

apps/backend/
├── core/                # Client, authentification, worktree, plateforme
│   ├── client.py        # Client Claude Agent SDK
│   ├── auth.py          # Gestion multi-profils OAuth
│   ├── worktree.py      # Isolation des espaces de travail Git
│   └── platform.py      # Abstraction cross-plateforme
├── agents/              # Logique d'exécution des agents
│   ├── planner/         # Agent de planification
│   ├── coder/           # Agent de développement
│   └── session/         # Gestion des sessions
├── qa/                  # Pipeline de validation QA
│   ├── reviewer/        # Validation des critères
│   ├── fixer/           # Résolution automatique
│   └── loop/            # Boucle de validation
├── spec/                # Création et gestion des specs
├── skills/              # Système de compétences AI optimisé
├── cli/                 # Interface ligne de commande
├── context/             # Construction du contexte des tâches
├── services/            # Services d'intégration externes
├── integrations/        # Connecteurs (GitHub, GitLab, etc.)
├── project/             # Analyse et détection de projets
└── merge/               # Système de fusion sémantique

Frontend Electron (apps/frontend/)

apps/frontend/src/
├── main/                # Processus principal Electron
│   ├── agent/           # Gestion des files d'attente
│   ├── claude-profile/  # Gestion multi-profils
│   ├── terminal/        # Daemon PTY et cycle de vie
│   ├── platform/        # Abstraction cross-plateforme
│   ├── ipc-handlers/    # 40+ modules de gestion IPC
│   └── services/        # Récupération de session SDK
├── renderer/            # Interface React
│   ├── features/        # Modules fonctionnels auto-contenus
│   │   ├── tasks/       # Gestion des tâches, kanban
│   │   ├── terminals/   # Émulation de terminal
│   │   ├── projects/    # Gestion de projet, explorateur
│   │   ├── settings/    # Paramètres application/projet
│   │   ├── roadmap/     # Génération de roadmap
│   │   ├── insights/    # Analyse de code
│   │   └── agents/      # Gestion profils Claude
│   ├── shared/          # Ressources partagées
│   └── hooks/           # Hooks au niveau application
└── shared/              # Partagé main/renderer
    ├── types/           # Définitions TypeScript
    ├── constants/       # Constantes application
    └── utils/           # Utilitaires partagés

Flux de Données et État

Flux d'Exécution des Agents

  1. Création de Tâche → Utilisateur crée une tâche dans l'UI/CLI
  2. Génération de Spec → L'AI analyse la complexité et crée une spécification
  3. Phase de Planification → Le Planner décompose en sous-tâches
  4. Implémentation → Le Coder exécute avec des sous-agents parallèles
  5. Validation QA → Le Reviewer valide l'implémentation
  6. Résolution des Problèmes → Le Fixer résout les problèmes identifiés
  7. Phase de Fusion → Fusion sémantique vers la branche principale

Gestion d'État

  • État Projet → project-store.ts
  • État Tâche/Spec → task-store.ts
  • État Terminal → terminal-store.ts
  • État Agent → agent-state.ts
  • État Paramètres → settings-store.ts

Sécurité et Isolation

Modèle de Sécurité à 3 Couches

  1. Sandbox OS → Commandes Bash exécutées en isolation
  2. Restrictions Filesystem → Opérations limitées au répertoire projet
  3. Allowlist Dynamique → Commandes approuvées selon la stack détectée

Gestion des Credentials

  • Système de Profils Claude → Gestion OAuth multi-comptes
  • Stockage Secure → Keychain OS / Credential Manager
  • Rotation Automatique → Cycle de vie des tokens OAuth
  • Validation Input → Chemins et commandes sanitizées

Performance et Scalabilité

Modèle de Concurrence

  • Parallélisme d'Agents → Jusqu'à 12 terminaux AI parallèles
  • Opérations Async → I/O non-bloquant partout
  • Pooling de Ressources → Connexions et sessions réutilisées
  • Load Balancing → Switching automatique multi-comptes

Optimisations

  • Optimisation Tokens → Compression et cache du contexte
  • Gestion Mémoire → Cleanup agressif et checkpoints
  • Optimisation Réseau → Pooling de connexions et retries
  • Performance UI → Virtual scrolling et lazy loading

Installation et Configuration

Prérequis Système

Configuration Matérielle Minimale

  • OS : Windows 10+, macOS 10.15+, Ubuntu 20.04+
  • RAM : 8GB minimum (16GB recommandé)
  • Stockage : 2GB d'espace libre
  • Réseau : Connexion internet stable

Dépendances Logicielles

  • Node.js v24.12.0 LTS (Requis)
  • Python 3.12+ (Pour le backend)
  • Git (Dépôt initialisé obligatoire)
  • Claude Code CLI : pnpm install -g @anthropic-ai/claude-code

Méthodes d'Installation

Option 1 : Application Bureau (Recommandé)

  1. Téléchargement

    • Visitez GitHub Releases
    • Téléchargez la version stable pour votre plateforme
  2. Installation

    • Windows : Exécutez WorkPilot-AI-1.0.0-win32-x64.exe
    • macOS : Ouvrez WorkPilot-AI-1.0.0-darwin-arm64.dmg
    • Linux : Lancez WorkPilot-AI-1.0.0-linux-x86_64.AppImage
  3. Premier Lancement

    • Lancez l'application
    • Suivez l'assistant de configuration
    • Connectez votre provider AI

Option 2 : Développement depuis Source

  1. Clonage du Dépôt

    git clone https://github.com/tleub-ebp/WorkPilot-AI.git
    cd Auto-Claude_EBP
    
  2. Installation Automatique

    pnpm install
    pnpm run dev
    

    Crée automatiquement l'environnement virtuel Python et installe toutes les dépendances

  3. Lancement Manuel

    # Backend
    cd apps/backend
    python -m pip install -r requirements.txt
    
    # Frontend
    cd ../frontend
    pnpm install
    pnpm run dev
    

Configuration des Providers AI

Authentification Claude (Recommandé)

claude
# Tapez : /login
# Appuyez sur Entrée pour ouvrir le navigateur

Le token est automatiquement sauvegardé dans le Keychain OS

Configuration Multi-Providers

ProviderMéthodeConfiguration
Anthropic ClaudeOAuth ou API KeyANTHROPIC_API_KEY
OpenAIAPI KeyOPENAI_API_KEY
Google GeminiAPI KeyGOOGLE_API_KEY
Grok / xAIAPI KeyXAI_API_KEY
OllamaEndpoint localOLLAMA_BASE_URL
GitHub CopilotOAuthVia interface
Azure OpenAIAPI Key + EndpointAZURE_OPENAI_*

Variables d'Environnement Optionnelles

# .env-files/.env
AUTO_BUILD_MODEL=claude-3-5-sonnet-20241022
DEBUG=true
LINEAR_API_KEY=votre_clé_linear
GRAPHITI_ENABLED=true

Configuration du Projet

Structure de Projet Requise

votre-projet/
├── .git/                # Obligatoire : dépôt Git initialisé
├── package.json         # Pour projets Node.js
├── requirements.txt     # Pour projets Python
├── Cargo.toml           # Pour projets Rust
└── ...                  # Vos fichiers de code

Détection Automatique de Stack

WorkPilot AI détecte automatiquement :

  • Framework : React, Vue, Angular, Django, Flask, Express
  • Language : TypeScript, JavaScript, Python, Rust, Go
  • Build Tools : Vite, Webpack, Cargo, Poetry
  • Testing : Jest, Pytest, Vitest, Playwright

Validation de l'Installation

Tests de Connexion

# Test du provider AI
pnpm test:provider

# Test du backend
pnpm test:backend

# Test complet de l'application
pnpm test

Vérification de l'Environnement

# Version Node.js
node --version  # v24.12.0

# Version Python
python --version  # 3.10+

# Configuration Claude
claude --version

Dépannage Courant

Problèmes d'Installation

  • Node.js non trouvé : Réinstallez depuis https://nodejs.org avec "Add to PATH"
  • Modules natifs : pnpm run rebuild dans apps/frontend
  • Python manquant : Installez Python 3.10+ et ajoutez au PATH

Problèmes d'Authentification

  • Token Claude expiré : claude puis /login
  • API Key invalide : Vérifiez les variables d'environnement
  • Problèmes OAuth : Révoquez et réautorisez l'application

Problèmes de Performance

  • Mémoire insuffisante : Fermez les applications inutiles
  • Timeout réseau : Vérifiez votre connexion internet
  • Lenteur UI : Redémarrez l'application

Project Structure

WorkPilot-AI/
├── apps/
│   ├── backend/     # Python agents, specs, QA pipeline, integrations
│   └── frontend/    # Electron desktop application (React + TypeScript)
├── docs/            # Documentation and guides
├── tests/           # Test suite
└── scripts/         # Build and release utilities

CLI Usage

For headless operation, CI/CD integration, or terminal-only workflows:

cd apps/backend
python spec_runner.py --interactive   # Create a spec interactively
python run.py --spec 001              # Run autonomous build
python run.py --spec 001 --review     # Review
python run.py --spec 001 --merge      # Merge

See docs/CLI-USAGE.md for the full CLI reference.


Security

WorkPilot AI uses a three-layer security model:

  1. OS Sandbox — Bash commands run in isolation
  2. Filesystem Restrictions — Operations limited to project directory
  3. Dynamic Command Allowlist — Only approved commands based on detected project stack

All releases include SHA256 checksums and VirusTotal scans.


Documentation

DocumentDescription
Setup GuideInstallation, requirements, scripts, dev environment
TroubleshootingCommon issues and fixes
Providers GuideMulti-provider LLM setup
CLI UsageHeadless / CI usage
ContributingCode style, testing, PR process
Linux GuideFlatpak, AppImage builds

Contributing

We welcome contributions! Please read CONTRIBUTING.md for development setup, code style, testing requirements, and PR process.


Community


License

AGPL-3.0 — GNU Affero General Public License v3.0

WorkPilot AI is free to use. If you modify and distribute it, or run it as a service, your code must also be open source under AGPL-3.0. Commercial licensing available for closed-source use cases.


Star History

GitHub Repo stars

Star History Chart

Ver o original no GitHub

Bom para

Relacionados