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.
- package/README.md +109 -28
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,20 +1,89 @@
|
|
|
1
1
|
# rempug
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://github.com/dianramdhani/rempug/actions/workflows/release.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/rempug)
|
|
5
|
+
[](LICENSE)
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
**Bagi pekerjaan ke banyak agent AI di tmux tanpa membakar token, tanpa dibohongi, dan tanpa Anda jadi kurir.**
|
|
6
8
|
|
|
7
|
-
|
|
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
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
51
|
-
codex ✓ siap ack
|
|
52
|
-
opencode ✗ tidak-andal
|
|
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
|
-
|
|
124
|
+
Sesudah itu Anda cukup meminta hasil. Hook awal sesi memulihkan status di sesi berikutnya, jadi `/rempug` tidak perlu diulang.
|
|
56
125
|
|
|
57
|
-
##
|
|
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
|
-
|
|
60
|
-
|
|
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
|
-
|
|
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,
|
|
89
|
-
- Konfirmasi pemahaman menangkap salah paham pada **cakupan, cek, dan tindakan terlarang**, bukan salah paham makna pada
|
|
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/)
|
|
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
|
|