Metadata-Version: 2.4
Name: adacode-kirocrew
Version: 0.1.3
Summary: Backend adaCODE untuk Kiro Crew — arahkan sesi agen ke gateway Anthropic-compatible, tanpa kiro-cli dan tanpa akun AWS
Author: adaCODE Platform
License: MIT
Project-URL: Homepage, https://adacode.ai
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.9
Dynamic: license-file

# adacode-kirocrew

Menjalankan [Kiro Crew](https://github.com/kirodotdev/KiroCrew) di atas
[adaCODE](https://adacode.ai) — **tanpa kiro-cli dan tanpa akun Kiro/AWS**.

Kiro Crew adalah orkestrator agen open source dari AWS: sesi persisten, cron,
triase PR/issue, konektor Slack/Telegram. Edisi publiknya menyetir `kiro-cli`
lewat Agent Client Protocol dan menagih kredit Kiro. Paket ini mengalihkan lapisan
modelnya ke gateway adaCODE, sementara seluruh orkestrasinya tetap milik Crew.

## Pasang

```bash
pip install kirocrew adacode-kirocrew
npm install -g @agentclientprotocol/claude-agent-acp @anthropic-ai/claude-code
```

Lalu tulis `~/.kiro/crew/adacode.json`:

```json
{
  "base_url": "https://api.adacode.ai",
  "api_key": "sk-adacode-...",
  "model": "claude-sonnet-4-6",
  "small_model": "claude-sonnet-4-6"
}
```

Atau biarkan wizard yang menulisnya:

```bash
npx adacode setup      # pilih target "Kiro Crew"
```

Jalankan:

```bash
kirocrew gateway
```

## Cara kerjanya

Kiro Crew menyediakan entry point `kirocrew.plugins` untuk companion. Paket ini
mendaftar di sana, lalu:

1. **Backend sesi** — memakai seam `ACP_BACKEND_CLAUDE` yang sudah ada di Crew
   (`claude-agent-acp`), dan menyuntikkan `ANTHROPIC_BASE_URL`/`ANTHROPIC_AUTH_TOKEN`
   ke subprosesnya.
2. **Gerbang prasyarat** — melewati pemeriksaan kiro-cli, yang tidak mengukur apa
   pun di jalur ini karena kiro-cli tidak pernah dijalankan.
3. **Katalog model** — `GET /api/models` dilayani dari `/v1/models` gateway, bukan
   dari `kiro-cli --list-models`.
4. **Biner Claude di Windows** — menunjuk `CLAUDE_CODE_EXECUTABLE` ke `claude.exe`
   asli. Shim `claude.cmd` dari npm membuat Node melempar `spawn EINVAL` dan sesi
   gagal init sebelum satu token pun terkirim.

Hanya nomor 1 yang memakai seam resmi; tiga sisanya menambal fungsi karena Crew
publik belum menyediakan seam di sana.

## Catatan

- **Model wajib ada di katalog akun.** Bila `model` dikosongkan, Claude Code
  memakai bawaannya (mis. `claude-opus-5`) yang bisa berada di luar katalog Coding
  Plan dan ditolak dengan 402.
- **Tanpa `api_key`, plugin diam.** Crew tetap boot dengan perilaku aslinya
  (kiro-cli), bukan membajak setiap sesi lalu gagal di setiap giliran.
- **Windows tidak punya sandbox OS.** Panggilan tool Crew tetap butuh
  `agent.sandbox_allow_unsandboxed_exec` di `~/.kiro/crew/config.json` — itu
  keputusan pengguna, dan paket ini tidak menyalakannya diam-diam.
- Diuji terhadap Kiro Crew 0.2.0.

## Lisensi

MIT
