convez.ai
AgenteAutomaçãoAvançado
QrCommunication

ClaudeNest

QrCommunication/claudenest

Orquestração remota de múltiplos agentes Claude Code com contexto compartilhado

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma de orquestração multi-agente para Claude Code que permite coordenar múltiplas instâncias de Claude trabalhando em paralelo em tarefas complexas de desenvolvimento. Oferece terminais remotos, sincronização de contexto via RAG, travamento distribuído de arquivos e execução coordenada de tarefas com agents especializados (Planejamento e Runner).

Instalação

$npx convez-ai QrCommunication/claudenest

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
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
agent-v2.6.8
Issues abertas
3
Contribuidores
4

Casos de uso

  • Coordenar múltiplos agentes Claude trabalhando no mesmo projeto simultaneamente
  • Executar tarefas de desenvolvimento complexas com divisão inteligente de trabalho
  • Gerenciar projetos com sprints, epics e burndown charts em time de agents
  • Recuperar contexto semanticamente relevante via embeddings para cada instância

Veredito

ClaudeNest é uma solução robusta para automação empresarial de desenvolvimento, combinando orquestração multi-agente com gerenciamento de projeto. Recomendado para times que precisam escalar trabalho de codificação via múltiplos agentes Claude com sincronização e contexto compartilhado.

README

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

ClaudeNest

Remote Claude Code orchestration platform -- control, coordinate, and scale Claude Code instances from anywhere.

License: PolyForm Noncommercial Laravel 13 Vue 3.5 Vite 8 TypeScript 6 Tailwind 4 Expo 55 React Native 0.83


What is ClaudeNest?

ClaudeNest turns Claude Code into a remotely accessible, multi-agent platform. Pair any machine running the agent daemon, then create and manage terminal sessions from a web dashboard or native mobile app. When multiple Claude instances work on the same project, ClaudeNest coordinates them through shared context (RAG), file locking, and an atomic task system.


Features

Remote Terminal Sessions

Real-time terminal access via xterm.js and WebSocket (Laravel Reverb). Full PTY support with resize, search, and WebGL rendering.

Machine Pairing

Six-character pairing codes (XXX-XXX) generated by the agent. Enter the code in the dashboard or mobile app to link a machine instantly.

Multi-Agent Orchestration

Run multiple Claude Code instances on the same project. Each instance can claim tasks, lock files, and share context without conflicts.

Context RAG

pgvector-powered retrieval-augmented generation. Project context is embedded (384-dimensional vectors via bge-small-en-v1.5) and retrieved by semantic similarity so every instance has the right information.

File Locking

Distributed file locks prevent two agents from editing the same file. Locks expire automatically and can be force-released when needed.

Task Coordination

Atomic task claiming ensures no two instances pick up the same work. Tasks track status, dependencies, completion summaries, and modified files.

Skills and MCP Servers

Discover, register, and toggle Claude Code skills per machine. Manage MCP (Model Context Protocol) servers and execute their tools remotely.

Authentication

Magic link login, plus OAuth via Google and GitHub. Token-based API access for agents and integrations.

Project Management

Built-in Epics, Sprints, and Kanban boards with burndown charts. Organize tasks into features, plan time-boxed sprints, and track velocity across your multi-agent projects.

Planning Agent

AI-powered conversational project planning. Describe what you need, and the Planning Agent decomposes it into structured tasks, assigns them to the right agents, and executes changes in atomic database transactions.

Runner Agent

Automated project health monitoring and sprint tracking. The Runner Agent continuously checks task statuses, flags blockers, updates sprint progress, and surfaces insights so nothing falls through the cracks.

Smart File Locking

Atomic lock acquisition with task-lock integration and heartbeat auto-extend. Locks are tied to active tasks and automatically renewed while work is in progress, then released on task completion.

Mobile Apps

Native iOS and Android apps built with React Native. Monitor machines, manage sessions, and coordinate agents on the go.


Architecture

flowchart TB
    subgraph Clients
        Web["Web Dashboard\nVue 3 + xterm.js"]
        Mobile["Mobile App\nReact Native"]
        Agent["Agent Daemon\nNode.js + node-pty"]
    end

    subgraph Server["ClaudeNest Server -- Laravel 12"]
        API["REST API\nSanctum Auth"]
        WS["WebSocket\nReverb"]
        RAG["RAG Engine\nEmbeddings + Search"]
    end

    subgraph Infra["Infrastructure"]
        PG["PostgreSQL 16\n+ pgvector"]
        Redis["Redis 7\nCache / Queues"]
        Ollama["Ollama\nbge-small-en + Mistral 7B"]
    end

    Web -->|HTTPS| API
    Web -->|WSS| WS
    Mobile -->|HTTPS| API
    Mobile -->|WSS| WS
    Agent -->|WSS| WS

    API --> PG
    WS --> Redis
    RAG --> PG
    RAG --> Ollama

Project Management System

Epics group related tasks into named features with progress tracking visible across the board. Sprints add time-based planning: each sprint has a start and end date, a velocity target, and a live burndown chart generated from task completion events.

The Planning Agent receives the full project context (summary, architecture, active tasks, current sprint) before each conversation turn. Every action it proposes — creating tasks, moving them between epics, starting a sprint — executes inside an atomic database transaction, so the project state is always consistent even when multiple agents are running simultaneously.

The Runner Agent runs on a schedule and does not require user interaction. It scans open tasks for stale statuses, detects blocked items whose blockers have since resolved, recalculates sprint burndown, and posts structured health summaries back to the project activity log.


Tech Stack

LayerTechnologyVersion
BackendLaravel (PHP 8.4+)13
FrontendVue.js (Composition API)3.5
BuildVite + Rolldown (Rust)8.0
State (Web)Pinia3.0
Terminalxterm.js + WebGL addon5.5
StylingTailwind CSS (CSS-first)4.1
TypeScriptStrict mode6.0
WebSocketLaravel Reverb1.10
AuthLaravel Sanctum + Socialite4.x
DatabasePostgreSQL + pgvector16+
Cache/QueueRedis7+
AgentNode.js + TypeScript + node-pty24 LTS
MobileExpo 55, React Native, React 190.83
Mobile StateZustand5.0
Mobile AnimationsReanimated (New Architecture)4.2
EmbeddingsOllama (bge-small-en-v1.5)--
SummarizationOllama (Mistral 7B)--

Quick Start

Prerequisites

  • PHP 8.3+, Composer
  • Node.js 20+, npm
  • PostgreSQL 16+ with the pgvector extension
  • Redis 7+
  • Ollama (optional, for RAG features)

Option A -- Docker

git clone https://github.com/QrCommunication/claudenest.git
cd claudenest

cp packages/server/.env.example packages/server/.env
docker compose up -d

docker compose exec server php artisan key:generate
docker compose exec server php artisan migrate

See docs/DEPLOYMENT-DOCKER.md for the full Docker guide.

Option B -- Local development

git clone https://github.com/QrCommunication/claudenest.git
cd claudenest

# Server setup
cd packages/server
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate

# Start everything (server, Vite, Reverb, queue worker)
composer dev

The composer dev script launches four processes in parallel:

ProcessURL
Laravel serverhttp://localhost:8000
Vite dev serverhttp://localhost:5173
Reverb WebSocketws://localhost:8080
Queue worker(background)

See docs/DEPLOYMENT-BAREMETAL.md for production setup.

Agent setup

cd packages/agent
npm install
npm run dev

Mobile setup

cd packages/mobile
npm install

# iOS
npm run pod-install
npm run ios

# Android
npm run android

Project Structure

claudenest/
  packages/
    server/                   Laravel 12 + Vue 3 SPA
      app/
        Http/Controllers/Api/   REST API controllers
        Models/                 Eloquent models (UUID, pgvector)
        Services/               Business logic (RAG, MCP, Skills)
        Events/                 Broadcast events
      resources/js/             Vue 3 SPA
        components/             UI components by domain
        composables/            Vue composables
        pages/                  Page-level components
        stores/                 Pinia stores
      routes/
        api.php                 API routes
        channels.php            Broadcast channels
      database/migrations/      Schema migrations

    agent/                    Node.js daemon
      src/
        sessions/               PTY management
        websocket/              WebSocket client
        discovery/              Skills & MCP discovery
        context/                Context sync client

    mobile/                   React Native app
      src/
        screens/                App screens
        components/             Shared components
        stores/                 Zustand stores
        services/               API & WebSocket clients

  docs/                       Extended documentation
  scripts/                    Install & setup scripts
  branding/                   Logos, banners, brand guidelines

API Reference

The most commonly used endpoints are listed below. For the full API reference, see docs/API.md.

Authentication

MethodEndpointDescription
POST/api/auth/loginLogin with credentials
POST/api/auth/registerRegister new user
GET/api/auth/meCurrent user profile
GET/api/auth/{provider}/redirectOAuth redirect (google, github)

Machines

MethodEndpointDescription
GET/api/machinesList paired machines
POST/api/machinesRegister a machine
GET/api/machines/{id}Machine details
POST/api/machines/{id}/regenerate-tokenRegenerate auth token

Sessions

MethodEndpointDescription
POST/api/machines/{id}/sessionsCreate terminal session
POST/api/sessions/{id}/inputSend input to session
POST/api/sessions/{id}/resizeResize PTY
DELETE/api/sessions/{id}Terminate session

Multi-Agent (Projects, Tasks, Locks)

MethodEndpointDescription
POST/api/machines/{id}/projectsCreate shared project
POST/api/projects/{id}/context/querySemantic context search
POST/api/projects/{id}/tasksCreate task
POST/api/tasks/{id}/claimClaim task (atomic)
POST/api/projects/{id}/locksLock a file
POST/api/projects/{id}/locks/releaseRelease file lock

Epics

MethodEndpointDescription
GET/api/projects/{id}/epicsList epics
POST/api/projects/{id}/epicsCreate epic
PATCH/api/epics/{id}Update epic
DELETE/api/epics/{id}Delete epic
POST/api/projects/{id}/epics/reorderReorder epics

Sprints

MethodEndpointDescription
GET/api/projects/{id}/sprintsList sprints
POST/api/projects/{id}/sprintsCreate sprint
PATCH/api/sprints/{id}Update sprint
POST/api/sprints/{id}/startStart sprint
POST/api/sprints/{id}/completeComplete sprint
GET/api/sprints/{id}/burndownBurndown chart data

Planning Agent

MethodEndpointDescription
GET/api/projects/{id}/planning/contextFull project context for planning
POST/api/projects/{id}/planning/executeExecute planning action (atomic)

Runner Agent

MethodEndpointDescription
GET/api/projects/{id}/runner/healthProject health report
POST/api/projects/{id}/runner/auto-updateTrigger status auto-update
GET/api/projects/{id}/runner/progressSprint progress and velocity

Configuration

Key environment variables (packages/server/.env)

# Database (PostgreSQL + pgvector required)
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=claudenest

# WebSocket (Laravel Reverb)
REVERB_APP_ID=claudenest
REVERB_APP_KEY=your-reverb-key
REVERB_APP_SECRET=your-reverb-secret
REVERB_SERVER_PORT=8080

# OAuth (optional)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

# AI Models (optional, for RAG)
OLLAMA_HOST=http://localhost:11434
OLLAMA_EMBEDDING_MODEL=bge-small-en-v1.5
OLLAMA_SUMMARIZATION_MODEL=mistral:7b

See docs/AI-MODELS.md for Ollama setup and model configuration.

Agent configuration (packages/agent/config.json)

{
  "serverUrl": "ws://localhost:8080",
  "machineToken": "mn_...",
  "claudePath": "/usr/local/bin/claude",
  "sessions": { "maxSessions": 10 }
}

Development

Server

cd packages/server

# Start all services
composer dev

# Run tests
php artisan test

# Lint PHP
./vendor/bin/pint

# Type-check Vue/TS
npm run typecheck

Agent

cd packages/agent

npm run dev          # Watch mode
npm run build        # Compile TypeScript
npm run test         # Run tests
npm run typecheck    # Type check

Mobile

cd packages/mobile

npm start            # Metro bundler
npm run ios          # Run on iOS simulator
npm run android      # Run on Android emulator
npm run typecheck    # Type check

Deployment

Production deployment guides:

An automated install script is available for Ubuntu/Debian servers:

./scripts/install-server.sh

Documentation

Technical (Developers)

DocumentDescription
CLAUDE.mdAI agent reference — single source of truth for the codebase
CHANGELOG.mdAll notable changes (Keep a Changelog format)
docs/ARCHITECTURE.mdSystem design and technical reference
docs/API.mdFull API documentation
docs/AI-MODELS.mdOllama models and RAG configuration
docs/DEPLOYMENT-DOCKER.mdDocker deployment guide
docs/DEPLOYMENT-BAREMETAL.mdBare-metal production setup
docs/DOMAINS.mdDomain and DNS configuration
docs/CONTRIBUTING.mdContribution guidelines
docs/audit-docs.mdDocumentation inventory and gap analysis

Guides (Users)

DocumentDescription
Task CoordinationEpics, Sprints, subtasks, Planning Agent guide
File LockingAtomic locks, task integration, heartbeat
Online DocsFull documentation portal

Marketing & Business

DocumentDescription
docs/marketing/one-pager.mdProduct pitch — problem, solution, key numbers
docs/marketing/feature-highlights.mdFeature cards with benefits
docs/marketing/analyse-business.mdBusiness analysis — personas, use cases, competitive advantages
branding/BRAND-GUIDELINES.mdBrand identity and assets

Contributing

Contributions are welcome. Please read docs/CONTRIBUTING.md before opening a pull request.


License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

Copyright 2026 Rony Licha / QR Communication.

Ver o original no GitHub

Bom para

Relacionados