rempug 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +109 -28
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,20 +1,89 @@
1
1
  # rempug
2
2
 
3
- Delegasi kerja dari satu agent **orkestrator** (mis. Claude Code) ke agent CLI lain (Codex, Antigravity, opencode, Claude) yang berjalan di sesi **tmux**. Hemat token, terverifikasi mesin, dan tanpa file sampah di proyek.
3
+ [![CI](https://github.com/dianramdhani/rempug/actions/workflows/release.yml/badge.svg)](https://github.com/dianramdhani/rempug/actions/workflows/release.yml)
4
+ [![npm](https://img.shields.io/npm/v/rempug)](https://www.npmjs.com/package/rempug)
5
+ [![lisensi](https://img.shields.io/npm/l/rempug)](LICENSE)
4
6
 
5
- Anda hanya mengetik `/rempug` sekali. Sesudah itu orkestrator mendelegasikan, menunggu, memverifikasi, mengulang, dan mengalihkan pekerjaan sendiri; Anda hanya menilai apakah hasil yang Anda minta sudah benar.
7
+ **Bagi pekerjaan ke banyak agent AI di tmux tanpa membakar token, tanpa dibohongi, dan tanpa Anda jadi kurir.**
6
8
 
7
- ## Kenapa
9
+ Anda punya Claude Code, Codex, Antigravity, atau opencode. Masing-masing jalan di terminal, dan langganannya hanya bisa dipakai lewat CLI, bukan API. Anda ingin satu agent memimpin dan yang lain bekerja paralel. rempug adalah jembatannya: satu perintah `/rempug` di orkestrator, lalu Anda hanya menilai apakah hasilnya benar.
8
10
 
9
- - Membaca layar tmux mentah boros token dan rawan salah baca. Hasil kerja kembali lewat **perintah**, bukan lewat scrape layar.
10
- - Agent berupa model murah, jadi klaim mereka tidak dipercaya. **rempug menghitung sendiri** file yang berubah, menjalankan cek penerimaan, dan mendeteksi commit diam-diam.
11
- - Orkestrator tidak perlu diingatkan: `rempug watch` mendorong satu baris per kejadian, dengan kursor yang tersimpan sehingga tidak ada kejadian yang hilang.
12
- - Semua status disimpan di satu berkas SQLite di luar repo. Tidak ada `tasks/`, `state/`, atau `evidence/` di proyek Anda.
11
+ ## Kendala yang dihadapi siapa pun yang mencobanya
12
+
13
+ Siapa pun yang pernah menyuruh satu agent "tolong minta agent lain mengerjakan ini" akan bertemu masalah yang sama:
14
+
15
+ | Kendala | Yang sebenarnya terjadi |
16
+ |---|---|
17
+ | **Anda jadi kurir** | Menyalin tugas dari satu terminal ke terminal lain, lalu membawa hasilnya kembali. Orkestrator hanya mengelola, Anda yang mengangkut. |
18
+ | **Membaca layar tmux itu boros dan rapuh** | `capture-pane` mengembalikan kotak, garis, spinner, dan riwayat. Orkestrator membayar token untuk membaca noise, lalu masih bisa salah tafsir. |
19
+ | **Perintah "terkirim" belum tentu sampai** | Tiap TUI beda: ada yang menelan Enter pertama, ada yang hanya menerima paste, ada yang menahan teks di kotak input. Tugas diam-diam nyangkut. |
20
+ | **Agent murah suka mengaku selesai** | "Sudah beres!" padahal tes gagal, file lain ikut berubah, atau ada commit yang tidak diminta. Memeriksanya satu per satu memakan waktu dan token. |
21
+ | **Orkestrator tidak tahu agent sudah selesai** | Anda yang harus mengingatkan: "itu agent sudah selesai, coba cek". Anda jadi alarm. |
22
+ | **Dua agent menimpa file yang sama** | Satu working tree, dua agent, tanpa pagar. |
23
+ | **Skrip koordinasi buatan sendiri menumpuk sampah** | Ratusan berkas `tasks/`, `state/`, `evidence/` di repo, hanya dimengerti agent, ikut ter-commit. |
24
+
25
+ ## Cara rempug menyelesaikannya
26
+
27
+ | Tanpa rempug | Dengan rempug |
28
+ |---|---|
29
+ | Anda menyalin tugas ke tiap terminal | Orkestrator mengirim tugas sendiri: **satu baris** diketik ke agent, isi lengkapnya dibaca agent lewat perintah |
30
+ | Orkestrator membaca layar mentah | Hasil kembali lewat **perintah**, dan orkestrator hanya menerima **satu baris per kejadian** |
31
+ | Cara kirim ditebak, lalu nyangkut | Tiap agent **diukur** dulu (probe): teknik kirim mana yang benar-benar sampai |
32
+ | Percaya pengakuan agent | rempug **menghitung sendiri**: berkas yang berubah, hasil tes, commit diam-diam |
33
+ | Anda mengingatkan orkestrator | Kejadian **didorong** ke orkestrator, dengan kursor tersimpan sehingga tidak ada yang terlewat |
34
+ | Dua agent bentrok | Tugas yang cakupan berkasnya beririsan **ditolak** sebelum dikirim |
35
+ | Berkas koordinasi di repo | Semua di **satu berkas SQLite di luar repo**. Repo Anda tidak disentuh |
36
+ | Laporan penuh kode tugas dan istilah teknis | Laporan ke Anda **berupa kalimat biasa** |
37
+
38
+ Anda hanya mengetik `/rempug` sekali. Sesudahnya orkestrator memutuskan sendiri apa yang dibagi, menunggu, memeriksa, mengulang, dan memindahkan pekerjaan kalau agent bermasalah.
39
+
40
+ ## Cara kerja
41
+
42
+ Gambaran besarnya:
43
+
44
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/gambaran-besar.png" alt="Gambaran besar: Anda berbicara dengan orkestrator, orkestrator mengirim tugas lewat tmux ke agent codex, agy, dan opencode, hasilnya masuk ke ledger rempug, diverifikasi mesin, lalu satu baris hasil kembali ke orkestrator dan laporan kalimat biasa kembali ke Anda" width="480"></p>
45
+
46
+ Satu tugas dari awal sampai akhir. Perhatikan bahwa agent **tidak pernah dipercaya** sampai rempug memeriksanya sendiri:
47
+
48
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/satu-tugas.png" alt="Satu tugas dari awal sampai akhir: send, validasi, pointer, brief, paham, bekerja, reply, verifikasi oleh mesin, dan satu baris hasil lewat watch" width="640"></p>
49
+
50
+ Bila ada yang tidak beres, orkestrator naik tangga ini dan baru melibatkan Anda di akhir:
51
+
52
+ <p align="center"><img src="https://raw.githubusercontent.com/dianramdhani/rempug/main/docs/diagrams/tangga-masalah.png" alt="Tangga penanganan masalah: kirim ulang maksimal 2 kali, pindah ke agent lain, lalu orkestrator mengerjakan sendiri; bila butuh izin manusia, Anda diberi tahu satu kalimat" width="480"></p>
53
+
54
+ **Prompt izin tidak pernah dijawab otomatis.** Kalau sebuah agent menunggu persetujuan, rempug hanya melaporkannya kepada Anda.
55
+
56
+ ### Yang dilakukan rempug di balik layar
57
+
58
+ - **Probe saat `/rempug`**: mengirim tugas uji ke tiap agent dan mengukur teknik kirim yang sampai, waktu respons, dan seperti apa layarnya saat sibuk. Agent yang gagal ditandai `tidak-andal` dan tidak dipakai.
59
+ - **Konfirmasi pemahaman**: agent harus menyebut cakupan, cek, dan rencananya dulu. Kalau cocok dengan brief, disetujui mesin tanpa token orkestrator. Kalau menyimpang (misalnya rencananya menyentuh `package.json`), ditahan.
60
+ - **Verifikasi oleh mesin**: berkas yang berubah beserta jumlah barisnya, perubahan di luar cakupan (hanya nama berkas, karena bisa jadi edit Anda sendiri), cek penerimaan yang dijalankan rempug, dan commit atau pindah branch.
61
+ - **Pemantau layar**: mengulang pengiriman yang tertahan, melaporkan pertanyaan, prompt izin, dan kuota habis, mengirim satu pengingat, lalu menyatakan agent macet.
62
+
63
+ ## Contoh hasil
64
+
65
+ Satu baris per tugas, yang dibaca orkestrator (nilainya contoh, bentuknya nyata):
66
+
67
+ ```
68
+ T12 codex ✓ 1 file +3/−1 | scope OK | tsc ✓ biome ✓
69
+ T13 agy ⚠ pelanggaran: HEAD berubah (a1b2c3d→e4f5a6b)
70
+ ```
71
+
72
+ Yang sampai kepada Anda, dalam kalimat biasa (`rempug report --manusia`):
73
+
74
+ ```
75
+ Selesai (1)
76
+ - Ubah kolom tabel Devices (oleh codex): mengubah 1 berkas (3 baris ditambah, 1 dihapus); semua pengecekan lulus
77
+
78
+ Perlu perhatian (1)
79
+ - Ubah tema (oleh agy): mengubah riwayat git tanpa izin (membuat commit atau berpindah cabang); hasilnya tidak dipercaya
80
+ ```
13
81
 
14
82
  ## Kebutuhan
15
83
 
16
84
  - Linux atau macOS (butuh `tmux`)
17
85
  - Node.js 22.13 atau lebih baru (memakai `node:sqlite` bawaan, tanpa dependensi native)
86
+ - Agent pekerja yang bisa menjalankan perintah shell (Codex, Antigravity, opencode, dan sebagainya)
18
87
 
19
88
  ## Pemasangan
20
89
 
@@ -22,10 +91,10 @@ Anda hanya mengetik `/rempug` sekali. Sesudah itu orkestrator mendelegasikan, me
22
91
  npm i -g rempug
23
92
  ```
24
93
 
25
- Perintah `rempug` harus ada di PATH: hook sesi dan agent yang Anda delegasikan memanggilnya dari shell (`rempug doctor` memeriksanya). Lalu pasang skill dan server MCP untuk Claude Code, salah satunya:
94
+ Perintah `rempug` harus ada di PATH: hook sesi dan agent pekerja memanggilnya dari shell (`rempug doctor` memeriksanya). Lalu pasang skill dan server MCP untuk Claude Code. **Pilih salah satu, bukan keduanya:**
26
95
 
27
96
  ```bash
28
- # A. Plugin: skill /rempug + server MCP + hook awal sesi sekaligus
97
+ # A. Plugin: skill /rempug + server MCP + hook awal sesi, sekaligus
29
98
  claude plugin marketplace add dianramdhani/rempug
30
99
  claude plugin install rempug@rempug
31
100
 
@@ -34,40 +103,51 @@ rempug skill install
34
103
  claude mcp add --scope user rempug -- rempug mcp
35
104
  ```
36
105
 
37
- Pasang salah satu saja, bukan keduanya. Mulai sesi Claude Code yang baru agar skill `/rempug` dan tool MCP-nya dimuat. Biaya tetap plugin sekitar 74 token per sesi; skema tool MCP baru dimuat penuh saat dipakai.
106
+ `rempug skill install` hanya menyalin satu berkas petunjuk ke `~/.claude/skills/rempug/`. Itu yang membuat Claude tahu kapan dan bagaimana memakai rempug, dan yang membuat `/rempug` dikenali. Letaknya di tingkat user, jadi berlaku untuk semua proyek dan **tidak ada yang ditulis ke repo Anda**. Mulai sesi Claude Code yang baru bila `/rempug` belum muncul. Biaya tetap plugin sekitar 74 token per sesi (angka dari `claude plugin details`).
38
107
 
39
108
  ## Pemakaian
40
109
 
41
- Siapkan sesi tmux dan jalankan agent di dalamnya (beserta apa pun yang perlu disiapkan, mis. sesi Playwright), lalu di orkestrator:
110
+ Siapkan sesi tmux dan jalankan agent di dalamnya, beserta apa pun yang perlu disiapkan (misalnya sesi Playwright). Lalu di orkestrator:
42
111
 
43
112
  ```
44
113
  /rempug
45
114
  ```
46
115
 
47
- Orkestrator memindai tmux, menebak mana yang agent, bertanya **satu kali** untuk penamaan, lalu **mengukur** tiap agent (probe) dan menampilkan tabel kesiapan:
116
+ Orkestrator memindai tmux, menebak mana yang agent, bertanya **satu kali** untuk penamaan, lalu menguji tiap agent dan menampilkan kesiapannya, misalnya:
48
117
 
49
118
  ```
50
- agy ✓ siap ack 1.8 dtk
51
- codex ✓ siap ack 2.4 dtk
52
- opencode ✗ tidak-andal teks tertahan di kotak input; 7 kombinasi dicoba
119
+ agy ✓ siap ack 5.7 dtk
120
+ codex ✓ siap ack 6.1 dtk
121
+ opencode ✗ tidak-andal agent melaporkan galat (limit, kuota, atau autentikasi)
53
122
  ```
54
123
 
55
- Sesudahnya Anda cukup meminta hasil. Orkestrator memutuskan sendiri apa yang dibagi ke agent dan hanya melaporkan hasilnya: tujuan tercapai atau belum, bukti yang menentukan, dan keputusan yang butuh Anda. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
124
+ Sesudah itu Anda cukup meminta hasil. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
56
125
 
57
- ## Cara kerja
126
+ ## Status pengujian: yang sudah dan belum
127
+
128
+ | | Status |
129
+ |---|---|
130
+ | 247 uji otomatis, termasuk uji ujung ke ujung dengan tmux dan git nyata | Lulus di CI: Ubuntu (Node 22.13, 24, 26) dan macOS (Node 24) |
131
+ | **Claude Code sebagai orkestrator** | **Diuji dan dipakai** |
132
+ | Codex dan Antigravity sebagai **pekerja** | Diuji dengan agent asli: lulus probe, dan dua tugas edit paralel selesai dan terverifikasi |
133
+ | opencode sebagai pekerja | Pengiriman berhasil, tetapi saat uji akunnya gagal login (galat 401), jadi alurnya belum terbukti |
134
+ | **Codex, Antigravity, atau opencode sebagai orkestrator** | **Belum dicoba** |
135
+ | Claude sebagai pekerja | Belum dicoba |
136
+
137
+ ### Orkestrator selain Claude Code
138
+
139
+ **Belum dicoba.** Perintah `rempug` dan server MCP-nya mengikuti standar sehingga bisa jadi berfungsi di orkestrator lain, tetapi bagian yang paling terikat ke Claude Code belum punya padanan teruji:
58
140
 
59
- 1. `send` memvalidasi **brief** (TUJUAN, CAKUPAN, LANGKAH, CEK, BALASAN), menolak cakupan yang beririsan dengan tugas edit lain, mengambil snapshot berkas, lalu mengetik **satu baris pointer** ke pane agent.
60
- 2. Agent menjalankan `rempug brief` (ini bukti pengiriman), mengonfirmasi pemahaman lewat `rempug paham`, bekerja, lalu `rempug reply`. Konfirmasi yang cocok dengan brief disetujui otomatis tanpa token orkestrator.
61
- 3. Verifikasi berjalan di proses terlepas: berkas yang berubah (+/−), perubahan di luar cakupan (hanya nama), cek penerimaan yang dijalankan rempug sendiri, dan commit atau pindah branch.
62
- 4. `watch` mencetak satu baris, mis. `T12 codex ✓ 3 file +41/−7 | scope OK | tsc ✓ vitest ✗(2)`.
141
+ - skill `/rempug`, plugin, dan hook sesi adalah format Claude Code;
142
+ - orkestrator dibangunkan lewat tool `Monitor` milik Claude Code. Untuk yang lain ada cadangan (`rempug watch --bangun`) yang mengetik satu baris ke layar orkestrator saat layarnya diam, tetapi baru diuji dengan tiruan, bukan dengan agent sungguhan.
63
143
 
64
- Pemantau layar berjalan di dalam `watch`: mengulang pengiriman yang tertahan, melaporkan pertanyaan, prompt izin, dan limit, mengirim satu pengingat, lalu menyatakan agent macet. **Prompt izin tidak pernah dijawab otomatis.**
144
+ Kalau Anda mencobanya dengan orkestrator lain, hasilnya sangat berguna: silakan buka issue.
65
145
 
66
146
  ## Perintah
67
147
 
68
148
  Untuk orkestrator: `scan`, `register`, `probe`, `ls`, `status`, `doctor`, `send`, `jawab`, `log`, `show`, `diff`, `report`, `layar`, `watch`, `terima`.
69
- Untuk agent: `brief`, `paham`, `tunggu`, `reply`.
70
- Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalankan `rempug --help` untuk pemakaian lengkap.
149
+ Untuk agent pekerja: `brief`, `paham`, `tunggu`, `reply`.
150
+ Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalankan `rempug --help` untuk pemakaian lengkap. `rempug report --manusia` menghasilkan laporan berkalimat biasa, tanpa kode tugas dan simbol.
71
151
 
72
152
  ## Konfigurasi
73
153
 
@@ -85,9 +165,10 @@ Semuanya juga tersedia sebagai tool MCP (`rempug mcp`), kecuali `watch`. Jalanka
85
165
 
86
166
  ## Batasan yang perlu diketahui
87
167
 
88
- - **Deteksi keadaan layar bersifat heuristik** (teks tertahan, pertanyaan, prompt izin, limit). Ia teruji terhadap TUI palsu yang meniru perilaku berbeda, tetapi belum divalidasi terhadap setiap TUI sungguhan. Agent yang gagal probe ditandai `tidak-andal` dan tidak dipakai.
89
- - Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada TUJUAN. Untuk tugas berisiko gunakan `--teliti`; verifikasi sesudah kerja tetap menjadi jaring terakhir.
90
- - Pengecekan cakupan sengaja **konservatif**: path tanpa wildcard dianggap sebagai dirinya sendiri beserta isinya.
168
+ - **Deteksi keadaan layar bersifat heuristik** (teks tertahan, pertanyaan, prompt izin, kuota). Ia teruji terhadap TUI palsu yang meniru perilaku berbeda dan terhadap Codex dan Antigravity asli, tetapi belum divalidasi untuk setiap TUI. Agent yang gagal probe tidak dipakai.
169
+ - Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada tujuan. Untuk tugas berisiko gunakan `--teliti`; verifikasi sesudah kerja tetap menjadi jaring terakhir.
170
+ - Pengecekan cakupan sengaja **konservatif**: path tanpa wildcard dianggap sebagai dirinya sendiri beserta isinya. Kadang ia menolak tugas yang sebenarnya aman, demi tidak membiarkan dua agent menimpa file yang sama.
171
+ - Pada tugas `baca` dan `browser`, kolom `CEK` adalah deskripsi bukti yang harus dilaporkan agent, bukan perintah yang dijalankan. Perintah shell hanya dijalankan untuk tugas `edit`.
91
172
  - Windows tidak didukung (tmux).
92
173
 
93
174
  ## Pengembangan
@@ -99,7 +180,7 @@ npm run typecheck
99
180
  npm test # butuh tmux; termasuk uji ujung ke ujung
100
181
  ```
101
182
 
102
- Commit mengikuti [Conventional Commits](https://www.conventionalcommits.org/); versi, `CHANGELOG.md`, GitHub Release, dan publish npm dihasilkan otomatis oleh semantic-release dari cabang `main`.
183
+ Commit mengikuti [Conventional Commits](https://www.conventionalcommits.org/). Versi, `CHANGELOG.md`, GitHub Release, dan publish npm dihasilkan otomatis oleh semantic-release dari cabang `main`.
103
184
 
104
185
  ## Lisensi
105
186
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "rempug",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Distribusi kerja dari agent orkestrator ke agent CLI lain lewat tmux, hemat token.",
5
5
  "keywords": [
6
6
  "agent",