convez.ai
AgenteDevOps & InfraestruturaAvançado
TaraJura

Claude Code Cron Loop — Fábrica IA Autônoma

TaraJura/techtools-claude-code-cron-loop

Fábrica de software autônoma rodando agentes IA em cron para build contínuo

Ver no GitHub
InicialPluginScore · de 0 a 100

Um sistema multi-agente autônomo que executa Claude Code em cron para construir e manter continuamente um editor PDF web. 7 agentes colaboram a cada 4 horas via task board compartilhado, commitando mudanças automaticamente no GitHub. Demonstra orquestração de IA com permissões sudo em servidor Linux.

Instalação

$npx convez-ai TaraJura/techtools-claude-code-cron-loop

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
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Demonstração de multi-agentes colaborativos com Claude Code
  • Pipeline CI/CD autônomo com IA em servidor Linux
  • Prototipagem rápida de aplicações web via orquestração de agentes

Veredito

Projeto experimental ambicioso que prova viabilidade de pipelines autônomos com IA, mas requer infraestrutura complexa (servidor, cron, sudo) e está em reconstrução. Valioso para explorar limites de orquestração multi-agente, não para produção imediata.

README

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

PDF Editor — AI-Built Web Application

This entire project is built autonomously by Claude Code (AI) with full sudo permissions. 7 AI agents collaborate every 4 hours to design, implement, test, and secure a browser-based PDF editor. No human intervention required. The factory builds the product.

2026-06-07 — Migrated to a fresh server (vm3). The old deployment's app code stayed on the old VPS; the factory is rebuilding the PDF editor from scratch here. The app skeleton is now live — a working pdf.js viewer with drag-and-drop upload, zoom and fit-width (TASK-301). Features are being re-implemented on top from the roadmap below. The public domain still points at the old server until DNS cutover.


What Is This?

An autonomous AI factory that builds a professional PDF editor web application:

AspectDescription
ProductBrowser-based PDF Editor (rebuilding on vm3 — public URL https://cronloop.techtools.cz pending DNS cutover)
EngineClaude Code (Anthropic's AI CLI tool)
ExecutionMain pipeline every 4 hours + supervisor twice daily via crontab
PermissionsFull sudo access to the server
StackHTML/CSS/JS + pdf.js + pdf-lib + Tesseract.js
Sourcehttps://github.com/TaraJura/techtools-claude-code-cron-loop

Live App: viewer skeleton live — LAN: http://192.168.1.110/ (upload a PDF to view/zoom; public domain https://cronloop.techtools.cz still points at the old VPS until DNS cutover)


PDF Editor Features

The PDF editor is a Progressive Web App — installable, offline-capable, and runs entirely in the browser. PDFs never leave your device. The agents have shipped ~100 features across the categories below.

Viewing & Navigation

PDF viewer (pdf.js) · Minimap · Magnifier loupe · Presentation mode · Reader mode · Reading-progress tracker · Search · Find & replace · Bookmarks (browse + edit) · Auto table of contents · Multi-document tabs · Visual compare with side-by-side & slider diff

Annotation & Markup

Highlight / underline / strikethrough · Free draw · Built-in stamps · Custom stamp creator and library · Sticky notes · Text overlays · Edit existing PDF text · Annotation summary list · FDF/XFDF import & export · Annotation presets · Multi-select · Color picker

Document Manipulation

Merge · Interleave pages from two PDFs · Split by ranges, bookmarks, or file size · Reorder / rotate / delete / duplicate pages · Resize pages to standard formats · Insert blank or existing pages · Manual & auto crop · Deskew scanned pages · Brightness / contrast / grayscale adjust

Forms & Signatures

Fill interactive PDF forms · Form data import/export (FDF, XFDF, JSON) · Form-field creator · Auto-detect fields on flat PDFs · Draw / type / upload digital signatures · Verify embedded digital signatures

Conversion & Export

OCR (Tesseract.js) · Extract text to .txt · PDF ↔ Image (PNG / JPEG) · Image to PDF · Extract images · Extract tables to CSV / XLSX · Export to DOCX, PPTX, HTML, Markdown, EPUB, SVG

Security & Privacy

Password protection / encryption · Manual redaction · Smart PII auto-redaction (worker-based) · Sanitize (strip JS, embedded files, hidden layers) · Flatten annotations into pages

Document Enhancements

Text & image watermarks · Bates numbering (legal) · Page numbers · Custom page labels (i, ii, A1, …) · Headers & footers · Backgrounds & borders · Hyperlinks & link manager · QR / barcode generation and scanning

Optimization & Compliance

Compress PDFs · PDF/A archival conversion · Print preparation (bleed, marks) · Repair corrupted PDFs · Font inspector · Document statistics · Metadata editor

Productivity

Batch processing · Document templates · Snipping tool · Distance / area measurements · Rulers and snap guides · OCG layer management · Attached-file manager · Duplicate-page detection · Image catalog · Clipboard helpers · Global undo / redo · Autosave to local storage

UI & Accessibility

ARIA / screen-reader support · Keyboard shortcuts · Cmd/Ctrl+K command palette · Right-click context menu · Customizable toolbars · Light / dark theme · Touch gestures · Text-to-speech

Integration & Storage

Drag-and-drop upload · Open from URL · Cloud storage integration · PWA install + offline service worker · Central action registry · Inter-module event bus

The full per-module feature table is in CLAUDE.md.

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│                    MAIN PIPELINE (Every 2 hours)                      │
│                                                                       │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐         │
│  │IDEA MAKER │─▶│    PM     │─▶│ DEVELOPER │─▶│DEVELOPER 2│         │
│  │           │  │           │  │           │  │           │         │
│  │ Generate  │  │ Assign    │  │ Build PDF │  │ Build PDF │         │
│  │ feature   │  │ tasks     │  │ editor    │  │ editor    │         │
│  │ ideas     │  │           │  │ features  │  │ features  │         │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘         │
│                                      │              │                 │
│                                      ▼              ▼                 │
│                           ┌────────────────────────────────┐         │
│                           │  /var/www/cronloop.techtools.cz │         │
│                           │  PDF Editor Web Application     │         │
│                           └────────────────┬───────────────┘         │
│                                            │                          │
│  ┌───────────┐  ┌───────────┐             │                          │
│  │ SECURITY  │◀─│  TESTER   │◀────────────┘                          │
│  │           │  │           │                                         │
│  │ Review    │  │ Verify    │                                         │
│  │ file      │  │ PDF ops   │                                         │
│  │ handling  │  │ work      │                                         │
│  └───────────┘  └───────────┘                                         │
│       │               │                                               │
│       └───────────────┴──────────▶ tasks.md ──▶ GitHub                │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│                    SUPERVISOR (Every 2 hours at :15)                   │
│                                                                       │
│                ┌─────────────────────────────────┐                    │
│                │          SUPERVISOR              │                    │
│                │                                  │                    │
│                │  • Monitors all agents            │                    │
│                │  • Checks system health           │                    │
│                │  • Tracks project progress         │                    │
│                │  • Fixes issues conservatively     │                    │
│                └─────────────────────────────────┘                    │
└──────────────────────────────────────────────────────────────────────┘

Tech Stack

LayerTechnologyPurpose
PDF Renderingpdf.js (Mozilla)Render PDF pages in the browser
PDF Manipulationpdf-libMerge, split, modify PDFs
OCRTesseract.jsExtract text from scanned PDFs
DOCX Exportdocx.umd.jsWord document export
PPTX ExportpptxgenjsPowerPoint export
Spreadsheetsxlsx (SheetJS)Table extraction → XLSX/CSV
ArchivesJSZipEPUB / DOCX / zip packaging
QR / Barcodeqrcode-generator, jsBarcode, jsQRGenerate and scan codes
FrontendHTML/CSS + native ES modulesUser interface (no build step)
PWAService Worker + manifest.jsonInstallable, offline-capable
Web ServerNginx 1.26.3 + Let's Encrypt SSLServe the application
AI EngineClaude CodeAutonomous development
SchedulingCronRun agents every 2 hours
Version ControlGit + GitHubTrack all changes

100% client-side. No backend, no bundler — modules are loaded directly by the browser. PDFs never leave the user's device.

Agents

Main Pipeline (Every 2 hours)

AgentRoleDescription
idea-makerIdeationGenerates PDF editor feature ideas
project-managerPlanningAssigns and prioritizes tasks
developerImplementationBuilds PDF editor features
developer2ImplementationBuilds features in parallel
testerQARuns a 6-phase browser smoke test in headless Chrome (chrome-devtools MCP) every cycle: homepage console check → example.pdf upload → post-upload geometry/visibility check (catches layout regressions where state says "loaded" but the user sees nothing) → tool-tab interaction sweep → zoom/fit-width viewer interaction → cleanup. Files SYSTEM CRITICAL entries on any failure — never patches bugs itself.
securitySecurityReviews file upload security, XSS prevention

Supervisor (Every 2 hours at :15)

AgentRoleDescription
supervisorOverseerMonitors ecosystem health and project progress

Each agent has a prompt file at actors/<agent>/prompt.md defining its behavior.

Task Lifecycle

┌──────────┐    ┌─────────────┐    ┌──────────┐    ┌──────────────┐    ┌──────────┐
│   TODO   │───▶│ IN_PROGRESS │───▶│   DONE   │───▶│   VERIFIED   │───▶│ ARCHIVED │
│          │    │             │    │          │    │              │    │          │
│ PM sets  │    │ Developer   │    │Developer │    │ Tester       │    │ Auto     │
│          │    │ starts      │    │completes │    │ approves     │    │ archive  │
└──────────┘    └─────────────┘    └──────────┘    └──────────────┘    └──────────┘
                                        │
                                        ▼ (if issues)
                                 ┌──────────┐
                                 │  FAILED  │ ──▶ Back to TODO
                                 └──────────┘

Project Structure

/home/novakj/techtools-claude-code-cron-loop/
├── CLAUDE.md              # Core system rules
├── README.md              # This file
├── tasks.md               # Task board
├── docs/                  # Documentation
│   ├── autonomous-system.md  # How the AI factory works
│   ├── server-config.md      # Server specs and paths
│   ├── security-guide.md     # PDF security guidelines
│   └── engine-guide.md       # Self-healing and recovery
├── status/                # System state (overwritten each cycle)
│   ├── system.json
│   ├── security.json
│   └── task-counter.txt
├── logs/                  # Execution logs
│   ├── changelog.md
│   └── tasks-archive/
├── actors/                # Agent configurations
│   ├── idea-maker/prompt.md
│   ├── project-manager/prompt.md
│   ├── developer/prompt.md
│   ├── developer2/prompt.md
│   ├── tester/prompt.md
│   ├── security/prompt.md
│   └── supervisor/prompt.md
├── scripts/               # Orchestration scripts
│   ├── cron-orchestrator.sh
│   ├── run-actor.sh
│   ├── run-supervisor.sh
│   ├── mirror-webroot.sh  # Mirrors live web root -> web/ each tick (backup)
│   ├── maintenance.sh
│   ├── cleanup.sh
│   └── health-check.sh
├── web/                   # Git-tracked MIRROR of the live web root (recoverability
│   │                      #   backup, TASK-311). One-way copy of /var/www below;
│   │                      #   the live dir stays the source of truth — DO NOT edit
│   │                      #   web/ by hand (the mirror would overwrite it next tick).
│   ├── index.html
│   ├── css/  js/  lib/  assets/
│
/var/www/cronloop.techtools.cz/  # PDF Editor web app (PWA) — LIVE, served by nginx
├── index.html             # Single-page app entry point
├── manifest.json          # PWA manifest
├── sw.js                  # Service worker (offline cache)
├── offline.html           # Offline fallback page
├── css/
│   ├── main.css
│   ├── viewer.css
│   └── tools.css
├── js/                    # ~100 ES module feature files
│   ├── app.js                  # Bootstrap & wiring
│   ├── event-bus.js            # Inter-module pub/sub
│   ├── action-registry.js      # Central action registry
│   ├── viewer.js               # pdf.js viewer
│   ├── annotate.js             # Highlight/underline/strikethrough
│   ├── merge.js / split.js     # Combine / split docs
│   ├── forms.js / signatures.js
│   ├── ocr.js                  # Tesseract OCR
│   ├── redact.js / smart-redact.js
│   ├── docx-export.js / pptx-export.js / epub-export.js / ...
│   └── ... (~80 more)          # See CLAUDE.md for the full table
├── lib/                   # Vendored libraries (no build step)
│   ├── pdf.min.mjs / pdf.worker.min.mjs   # pdf.js
│   ├── pdf-lib.min.js                     # PDF manipulation
│   ├── tesseract.min.js                   # OCR
│   ├── jszip.min.js                       # ZIP/EPUB/DOCX
│   ├── docx.umd.js                        # DOCX export
│   ├── pptxgenjs.bundle.js                # PPTX export
│   ├── xlsx.full.min.js                   # Spreadsheet I/O
│   ├── qrcode-generator.min.js / jsbarcode.min.js / jsqr.min.js
│   └── ...
├── assets/
│   ├── icons/             # PWA + UI icons
│   └── fonts/             # Embedded fonts
└── templates/             # Document templates

Scheduled Tasks (Cron)

ScheduleScriptDescription
0 */2 * * *cron-orchestrator.shRun 6 agents sequentially
15 */2 * * *run-supervisor.shRun supervisor agent
0 * * * *maintenance.shHourly health checks
0 3 * * *cleanup.shDaily log cleanup

Server Specs

ResourceValue
OSUbuntu 25.04
CPU4 cores
RAM7.6 GB
Disk72 GB
Web ServerNginx 1.26.3 + Let's Encrypt SSL

Security

  • File upload validation (magic bytes, MIME type, size limits)
  • XSS prevention (no innerHTML with user content)
  • Content-Security-Policy headers
  • Nginx blocks sensitive paths (.git, .env, *.sh, *.md)
  • No server-side storage of user PDFs
  • Client-side processing only

Quick Commands

# Run all agents manually
./scripts/cron-orchestrator.sh

# Run a specific agent
./scripts/run-actor.sh developer

# Check system health
./scripts/health-check.sh

# View recent commits
git log --oneline -10

# Check cron jobs
crontab -l

Self-Improvement

The system learns from mistakes:

  1. Tester catches bugs → marks task FAILED with feedback
  2. Developer reads feedback → fixes the issue
  3. Agent prompts get updated → same mistake never happens again
  4. System gets permanently smarter over time

Built autonomously by Claude Code — an AI software factory Project started March 2026

Ver o original no GitHub

Bom para

Relacionados