memoryRuby gem · nad Claude Code

Autonómny vývojár, ktorý beží na vašom stroji a dotahuje úlohy až do zlúčeného PR.

mcptask_runner premení Claude Code na samostatného člena tímu. Funguje s Claude, Kimi, DeepSeek, lokálnou ollamou alebo akýmkoľvek modelom — bez vendor lock-inu. Vyberie úlohu, napíše kód aj testy, otvorí PR a po zelenom CI ho zlúči. Zadáte večer dobre špecifikovanú prácu, ráno ju nájdete hotovú.

Nainštalovať

terminal

mcptask_runner$ bundle exec rake mcptask_runner:manual:once

→ Triage: difficulty=13, model=opus, complexity=high

→ Picking next task#10959 (Nová veřejná stránka o mcptask_runner)

→ Snapshotstarting → triage → processing

→ Branchfeature/10959-runner-public-page

→ CI✓ green

→ PR auto-merged✓

→ Quota: 18% of daily budget used

1 commandto start

~2 minto first task

infoČo to je

Plný autonómny harness nad Claude Code

mcptask_runner je Ruby gem, ktorý do hostiteľskej Rails aplikácie pridá rake tasky pre automatizované vykonávanie úloh z mcptask.online cez Claude Code — od začiatku do konca. Riadi celý životný cyklus agentnej práce: nájde úlohu → posúdi zložitosť → zvolí model → spustí Claude Code → stráži beh watchdogom → dodrží dennú kvótu → (voliteľne) po CI zlúči PR.

auto_awesome

Nie je to len „tupý spúšťač" Claude Code. Pridáva orchestráciu, dohľad, zotavenie a riadenie kvality, ktoré holý Claude Code nemá.

starsPrečo si to nainštalovať

Čo z toho reálne máte

Rámcované prínosom pre freelancera alebo dev tím, nie technikou.

bug_report

Cudzie bugy sa premenia na sledované úlohy

Keď runner uprostred úlohy narazí na cudzí bug, založí si naň vlastný sledovaný úlohu, opraví ho a vráti sa k pôvodnej práci. Chaos sa zmení na auditovateľnú položku.

autorenew

Samo sa to zotaví a dotiahne

Preplnený kontext, zaseknutie alebo prerušenie úlohu nezabijú. Runner naviaže na silnejšom modeli a dotlačí prácu do PR. Úloha sa naozaj dokončí, nielen začne.

swap_horiz

Žiadny vendor lock-in na model

Úrovne genius / smart / primitive si namapujete v mcptask_runner.yml na Claude, Kimi, DeepSeek, lokálnu ollamu alebo čokoľvek chcete. Zmena poskytovateľa = jedna zmena premennej. Veľkí agenti vás zamknú na svoj prémiový model; runner nie.

savings

Riadené náklady na AI

Lacný model na čítanie, silný len na ťažké kódovanie. QuotaGuard (fail-closed) stráži denný rozpočet, aby nedošlo k preťaženiu. Predvídateľné výdaje.

storage

Beží na vašom stroji, proti realite

Spúšťa sa proti vašej reálnej PostgreSQL, vašim reálnym system testom a vašim reálnym screenshotom. Nie osekaný cloud sandbox s mockovanými dátami.

bedtime

Z backlogu hotové PR — aj cez noc

Naskladáte úlohy do mcptask.online. Runner ich odbavuje, zatiaľ čo robíte niečo iné alebo spíte. Ráno máte hotové a zlúčené PR.

schedule

Beží bez dozoru, podľa plánu

Každé pracovné ráno sa sám rozbehne a berie frontu. Žiadne babysittanie promptov.

verified

Vstavaná brána kvality

Nič sa nezlúči bez zeleného CI. Sami si volíte: auto-merge, alebo PR na ľudskú revíziu. Runner vie aj zapracovať review feedback.

visibility

Žiadna čierna skrinka — plná sledovateľnosť

Každý beh je sledovaná úloha s % postupu, živou kartou a JSON logmi. Auditovateľné, prehľadné pre celý tím.

groups

Násobí kapacitu tímu bez náboru

Autonómny vývojár, ktorý drží konvencie projektu (testy, CI, PR), riadený ľuďmi tam, kde to dáva zmysel.

storageVaše reálne prostredie

Na vašom stroji, proti realite

Cloud agenti bežia v očistených sandboxoch. Runner beží vo vašom reálnom Rails projekte.

database

Reálna databáza

Pripojí sa k vašej PostgreSQL, spúšťa migrácie a testuje proti reálnym tvarom dát — nie hračkárskej schéme.

fact_check

Reálne system testy

Capybara/Selenium beží proti vašej reálnej aplikácii. Screenshoty a prehliadačové kontroly znamenajú, že PR je naozaj overené.

code

Reálne commity a PR

Vetvy, commity a pull requesty žijú vo vašom repu, s vaším CI, pod vašou Git históriou.

sync_altCelý cyklus

Úloha → zlúčené PR → výkaz → faktúra

Runner nie je samostatný kóder. Jeho práca rovno tečie späť do mcptask.online.

task_alt

Vybraná úloha

merge

Zlúčené PR

schedule

Zapísaný výkaz

receipt_long

Odoslaná faktúra

loopSlučka + cieľ

Slučka berie úlohy, cieľ ich dokončuje

mcptask_runner spája pracovnú slučku (berie úlohu za úlohou z fronty) s cieľom (dokončí každú úlohu až do zeleného PR, nielen k „nejakým úpravám"). Vie bežať v štyroch režimoch:

play_arrow

Jedna úloha

Posúdenie a spracovanie jednej úlohy. Ideálne pre prvé behy a ladenie.

today

Dnešná práca

Slučka úloh do dosiahnutia dennej kvóty. PR zostávajú otvorené na ľudskú revíziu.

stream

Nepretržitá fronta

Priebežné spracovanie fronty, kým prichádzajú nové úlohy.

folder_open

Všetky úlohy jedného príbehu

Spracuje všetky dostupné úlohy v rámci jedného príbehu, podľa priority.

download_for_offlineJedným príkazom

Jeden príkaz urobí celý bootstrap

rake mcptask_runner:install vykoná celý setup: nakopíruje 11 bundled Claude Code skillov do .claude/skills/, skontroluje helper binárky, zlúči baseline oprávnenia do .claude/settings.local.json, obstará JWT token pre mcptask.online, zapíše SSE server do .mcp.json, opýta sa, do ktorého Epiku ukladať auto-nájdené bugy, a na macOS vygeneruje LaunchAgent pre spúšťanie vo všední dni o 08:00. Jeden riadok, zhruba dve minúty k prvej úlohe.

terminalmcptask_runner installer

$ bundle exec rake mcptask_runner:install
→ Installing 11 skills into ./.claude/skills/
→ Checking required helpers          ✓ ok
→ Merging permissions into
  .claude/settings.local.json
→ Provisioning MCPTASK_TOKEN
→ Writing .mcp.json                  ✓
→ macOS LaunchAgent scheduled
  (weekdays 08:00)                   ✓

Ready. Have a nice day.

autorenewÚdržba

Aktualizácie skillov bez straty vašich úprav

Po bumpu gemu stačí jeden rake mcptask_runner:update. Updater si drží manifest s content-hashom každého skillu a každý klasifikuje ako chýbajúci (skopíruje), identický (preskočí), zastaraný (aktualizuje) alebo lokálne upravený (nechá byť / s FORCE=1 zálohuje do .bak a prepíše). Nové schopnosti runneru dostanete automaticky, vaše vlastné úpravy skillov zostanú zachované. Git hooky navyše skilly re-syncujú po pull a checkoute. Verzia gemu sa inkrementuje automaticky post-merge hookom.

tips_and_updates

mcptask_runner:prepare:permissions zlúči baseline oprávnenia — súčasť bezúdržbovej prevádzky.

buildKľúčové vlastnosti

Čo robí autonómiu skutočne autonómiou

Nižšie je technický detail za tvrdením, že runner je „viac než spúšťač". Každá vlastnosť existuje preto, že by sa bez nej reálny beh rozsypal.

bug_report

Keď narazí na cudzí bug, založí naň úlohu a pozastaví sa

Ak runner behom práce narazí na URGENTNÝ bug, ktorý nesúvisí s aktuálnou úlohou, commitne a pushne rozrobenú prácu na feature vetvu, prepne na main (čistý strom), založí novú urgentnú bug úlohu a vráti jej id a názov. Runner si bug pripne na disk (UrgentBugPin), takže aj po reštarte ide najprv opraviť bug a až potom sa vracia k pôvodnej úlohe. Chaos z „narazil som na niečo cudzie" sa zmení na sledovateľnú, vlastnenú úlohu.

restore

Zotavenie po zaplnení kontextu alebo prerušení

Keď beh skončí kvôli preplneniu kontextu, kvóte alebo zásahu urgent bugu, úloha zostane in_progress a nedokončená práca zostáva na feature vetve. Ďalší beh ju naviaže: prečíta git log + stav vetvy, fetchne a zlúči origin/main, preskočí hotové kroky a povýši model na „genius" (Opus), aby úlohu dokončil silnejší model. Runner navyše obmedzuje spálenie kontextu: paralelné nezávislé nástroje, žiadne opakované čítanie súboru, žiadne pollovanie v slučkách, screenshoty konvertované a zmenšené. Dlhá úloha prežije naprieč behmi.

visibility

Watchdog a detekcia zaseknutia

HeartbeatMonitoring killne beh po 20 minútach nečinnosti, soft-warn na frozen po 3 minútach, stropy na zaseknuté nástroje, absolútny backstop 30 minút a pri každom tepe prepočíta dennú kvótu. StallDetector číta stream Claude Code riadok po riadku a spozná „točenie sa dokola" — opakované chyby Edit alebo Bash, rovnaký podpis nástroja bez zmeny súborov. Pri zaseknutí proces zabije; úloha zostane in_progress a nabudúce sa resumuje na Opuse. QuotaGuard je jediný zdroj pravdy o dennom rozpočte — fail-closed. Pri každom tepe sa obnoví log/runs/run_*.json, takže máte audit toho, čo sa naozaj stalo.

psychology

Triage a voľba modelu (tri úrovne)

Pred prácou prebehne Triage: posúdi zložitosť úlohy a odporučí model. Tri úrovne: genius (Opus — ťažké kódovanie), smart (Sonnet — triage, review), primitive (Haiku — len čítanie). ID modelov sú verziované, takže reťazce retry prežijú preplnenie kontextu.

verified

Kvalita: testy, CI, auto-merge

Honest executor ide plný workflow: vetva → kód → unit testy → screenshoty → system testy → push → PR → lokálne CI. Úloha nie je hotová, kým neprejde CI. V režimoch auto-squash runner po zelenom CI PR sám squash-merge; v manuálnych režimoch zostane PR otvorené na ľudskú revíziu. Runner vie aj spracovať review feedback na existujúcom PR.

swap_horizPre vývojárov

Model-agnostický cez konfiguráciu

Tri úrovne si namapujete na ľubovoľného poskytovateľa. Vymeňte Claude za ollamu, Kimi, DeepSeek alebo Alibaba DashScope jednou zmenou premennej.

terminalmcptask_runner.yml

models:
  genius:    minimax-m3:cloud
  smart:     kimi-k2.7-code:cloud
  primitive: deepseek-v4-flash:cloud

launcher:
  # Lokálna ollama
  command: [env, "ANTHROPIC_BASE_URL=http://localhost:11434", "ANTHROPIC_AUTH_TOKEN=ollama", "claude"]

memoryPre vývojárov

Prečo to nie je kúzlo

Šesť vlákien, jeden orchestrátor a stavový automat, ktorý drží agenta pod kontrolou.

settings

Pracovná slučka

Hlavné orchestračné vlákno. Riadi slučku, spúšťa Claude Code cez Open3.popen3 ako child proces vo vlastnej process group (kvôli čistému SIGTERM/SIGKILL celého stromu).

stream

Čítačka stdout

Číta výstup Claude Code (stream-json) riadok po riadku, ako vzniká. Parsuje eventy, počíta ich, hľadá TASKRUNNER_RESULT marker (signál dokončenia) a kŕmi StallDetector. Žiadne čakanie na koniec procesu — reaguje priebežne.

report

Čítačka stderr

Oddelene zachytáva chyby, aby neblokovala hlavný stream a vedelo sa rozlíšiť reálny pád od očakávaného ukončenia.

timer

Watchdog

Nezávislé strážiace vlákno, ktoré tepe podľa plánu: kill po 20 minútach nečinnosti, soft-warn na frozen po 3 minútach, stropy zaseknutých nástrojov, absolútny backstop 30 minút a pri každom tepe prepočíta dennú kvótu z REST. Je to jediný externý dozorca nad child procesom.

wifi

WebSocket do mcptask.online

EventStream drží perzistentný WebSocket (ActionCable, RunnerSessionChannel) spojenie na mcptask.online. Po otvorení pošle subscribe handshake, snapshoty posiela throttlovane (zhruba 0,5 s), ale zmenu stavu FSM pretlačí okamžite; pri výpadku sa asynchrónne znovu pripája s throttlom 30 s. Finálny „closed" snímok dostane grace okno 0,5 s, aby živá karta nezamrzla na starom stave. Premenná MCPTASK_RUNNER_DISABLE celý stream vypne (používa sa v testoch, aby ruby test/... nezakladal karty na produkcii).

lock

Thread-safe snapshot builder

Stavový automat (starting → triage → processing → waiting → finished / stalled / frozen / pending / error / closed) je chránený Mutexom a vracia immutable snapshot hash. Producent/konzument kontrakt má verziované schémy (docs/runner_snapshot_schema.md) — ani jedna strana ho nezmení bez bumpu verzie.

list_altKatalóg rake taskov

Čo všetko vie a ako sa to volá

Každá položka nižšie sa spúšťa ako bundle exec rake <task> z koreňa projektu. Voliteľné prepínače: verbose=true, ignore_quota=true. Varianty story a task vyžadujú argument — bez neho spadnú.

manage_searchManuálne režimy — PR zostáva otvorené na revíziu

mcptask_runner:manual:once

Jedna úloha. Triage a vykonanie.

mcptask_runner:manual:once_dry

Len zobrazí ďalšiu úlohu, nič nevykoná.

mcptask_runner:manual:today

Slučka úloh do dosiahnutia dennej kvóty.

mcptask_runner:manual:daily

Nepretržitá denná slučka.

mcptask_runner:manual:queue

Nepretržité spracovanie fronty.

mcptask_runner:manual:review

Opraví review feedback na PR aktuálnej vetvy.

mcptask_runner:manual:reviews

Slučka cez všetky PR s nevybaveným review.

mcptask_runner:manual:workflow

Najprv review, potom dnešné úlohy.

mcptask_runner:manual:story[STORY_ID]

Všetky úlohy v príbehu.

mcptask_runner:manual:task[TASK_ID]

Jedna konkrétna úloha.

auto_modeAuto-squash režimy — PR sa po CI sám zlúči

mcptask_runner:auto:once

Jedna úloha, auto-merge, koniec.

mcptask_runner:auto:squash:today

Dnešné úlohy, každá auto-merge.

mcptask_runner:auto:squash:story[STORY_ID]

Celý príbeh, auto-merge.

mcptask_runner:auto:squash:task[TASK_ID]

Jedna konkrétna úloha, auto-merge.

mcptask_runner:auto:squash:queue

Nepretržitá fronta, auto-merge.

build_circleÚdržba

mcptask_runner:install

Plný bootstrap: skilly, oprávnenia, token, .mcp.json, plánovač.

mcptask_runner:update

Obnoví bundled skilly bez straty lokálnych úprav.

mcptask_runner:prepare:permissions

Zlúči baseline oprávnenia.

mcptask_runner:bug_report

Založí high-priority bug s posledným run logom a (redigovanými) env configmi.

rocket_launch

Ráno zapnite stroj

mcptask_runner nenahrádza váš tím — násobí ho. Jeden Ruby gem, jeden riadok na inštaláciu, a váš backlog sa hýbe sám.

Nainštalovať Runner na GitHube

verified_user30 dní zadarmo. Bez kreditnej karty. Open source. Kedykoľvek zrušíte.