Vulgr Agent, Warp Agent benzeri, zaten kullandığınız terminalin içinde çalışan ajanlı bir shell’dir (CLI). Tek bir giriş satırı vardır:
- Shell komutları doğrudan kendi kalıcı shell’inizde çalışır.
- Doğal dil istekleri, her görev için en uygun modeli kendisi seçen bir LLM ajanına gider (model router).
Teknoloji
| Alan | Seçim |
|---|---|
| Dil / çalışma ortamı | TypeScript, Node.js ≥ 22, ESM |
| Build / test | tsup / vitest |
| TUI | Ink + React |
| Terminal | node-pty + @xterm/headless, OSC 633 shell entegrasyonu işaretçileri |
| LLM | @anthropic-ai/sdk (Anthropic Messages API, birincil); openai SDK planlı |
| Diğer | commander (CLI), zod (şema), picomatch / ignore (dosya eşleme) |
Temel tasarım kararları
- Sizin shell’iniz ile ajanın shell’leri ayrıdır. Ajan sizin prompt’unuza asla komut yazmaz; komutları kendi PTY oturumlarında çalışır ve bunlar sandbox’lanabilir. Uzun komutlar bir
session_iddöner vewrite_stdinile izlenir. - Geçmiş yalnızca sona eklenir. Değişen durum sistem promptuna değil reminder’lara girer; böylece prompt-cache öneki geçerli kalır.
- Araç hataları modele geri döner:
is_errorsonucu olarak iletilir; reddedilen bir izin de sizin notunuzla birlikte iletilir.
Durum
Hazır ve testlerle doğrulanmış: shell + agent döngüsü, on araç, izinler, router, retry, JSONL oturum kaydı, TUI, dayanıklılık / token optimizer ve headless mod.
Hedef ölçüm Terminal-Bench 2.0 (Harbor) üzerinde diğer agent harness’larıyla kıyastır.