Kurulum ve giriş
era komutunu kur, tarayıcınla giriş yap ve Era'daki her şeyi terminalden oku ya da değiştir.
era, terminaldeki Era'dır: her modülün her kaynağı ve her işlemi, ayrıca siteler (era init, era deploy) ve yapay zekâ asistanları (era mcp). Herkese açık Era API'siyle senin adına konuşur — uygulamada yapabildiğinden fazlasını asla yapamaz.
Kurulum
npm install -g @getera/cli
# ya da: bun add -g @getera/cli
era --helpSite komutları (era init, era dev, era build, era deploy) dışındaki her şey için Node 18 ya da üstü yeter; site komutları Bun ister — onları bunx era … olarak çalıştır.
Giriş
era loginKodu doğrula
era login bir adres ve kısa bir kod yazar, tarayıcını açar. Tarayıcıdaki kodun terminaldekiyle aynı olduğuna bak.
Terminalin nereye ulaşacağını seç
Era'nın onay kartında işletmeyi, terminalin kullanabileceği modülleri ve yalnız okuyup okumayacağını seç. Terminal tam olarak bunu alır — orada senin yapabildiğinden fazlasını asla.
Hazır
Signed in as Ada Lovelace — workspace 7f1c… — 14 modules.| Seçenek | Ne yapar |
|---|---|
--no-browser | Yalnız adresi yazar (SSH oturumları, sunucular). Adresi herhangi bir cihazda aç. |
--scope "crm retail:read" | Her şeyden azını iste; ör. satışın tamamı, mağaza yalnız okuma. |
--base-url http://localhost:3001 | Başka bir Era'ya giriş yap (geliştirme). |
--profile is | Birden çok girişi yan yana tut; her komuta --profile verebilirsin. |
Giriş, yalnız senin okuyabildiğin tek bir dosyada saklanır — Windows'ta %APPDATA%\era\credentials.json, diğerlerinde ~/.config/era/credentials.json (ERA_CONFIG_DIR ile taşınır). Kendiliğinden yenilenir; 60 gün hiç kullanılmazsa yeniden giriş yaparsın. era logout oturumu kapatır ve token'ı iptal eder.
CI ve betiklerde
era login yerine bir ortam değişkeni ver; kayıtlı girişten önce gelir:
export ERA_API_KEY=era_… # API anahtarı (Ayarlar → Gelişmiş → API anahtarları)
# ya da
export ERA_TOKEN=erat_… # OAuth erişim token'ı
export ERA_BASE_URL=https://app.getera.ioKim olduğuna bak
era whoamiAda Lovelace (2b9e…)
workspace 7f1c…
signed in era login · https://app.getera.io
scopes * offline_access
modules crm(read,write) retail(manage,read,write) …İlk komutların
era resources # burada okuyabildiklerin
era orders list --status unfulfilled --limit 20 # her sütun bir süzgeçtir
era orders list --where "total_amount[gte]=10000" --json
era orders get ORDER_ID
era actions retail # çalıştırabildiğin her mağaza işlemi
era actions retail.cancel_order # alanları ve ret nedenleri
era orders cancel_order ORDER_ID --reason "Müşteri istedi"
era crm capture_lead --customer-id CUSTOMER_ID --message "Yıllık planla ilgileniyor"
era run crm.capture_lead --data '{"customerId": "CUSTOMER_ID"}'
era api GET /api/v1/me # herhangi bir API çağrısı
era memory recall "Ada ne istemişti?"Alanlar --alan değer biçimindedir (kebab-case de olur: --customer-id); bütün bir JSON gövdesi --data '{…}', --data @dosya.json ya da stdin için --data - ile verilir. Çıktı tablodur; --json ham JSON verir. Her yazma bir tekrar önleme anahtarıyla gönderilir; bağlantı koptuktan sonra yeniden denemek işi iki kez yapmaz.
Kanal bağlı değilse mesaj komutları açıkça hata verir — hiçbir şey başka bir yoldan gitmez:
era channels
era whatsapp send --customer CUSTOMER_ID --text "Siparişin yola çıktı"
# era: WhatsApp is not connected — connect it in Settings → Integrations (…). Nothing was sent.Çıkış kodları
| Kod | Anlamı |
|---|---|
0 | Tamam |
2 | Hatalı komut ya da girdi |
3 | Giriş yapılmamış ya da giriş sona ermiş |
4 | Reddedildi: izin yok, bulunamadı ya da bir ön koşul tutmadı |
5 | Başarısız |
6 | Era'ya ulaşılamadı |
7 | Zaman aşımı — bir yazmayı yeniden denemeden önce sonucuna bak |
Bir Era sohbetinin içinde
Era Desktop'taki bir sohbetin terminalinde era, o sohbetin kendi oturum komutudur (era komutu) — era login gerekmez. Başka her yerde aynı program, bu sayfada anlatılan herkese açık komuttur.