Erişim anahtarları & MyWay CLI

Tarayıcı dışından MyWay’e bağlanmanın yolu kişisel erişim anahtarıdır: komut satırı aracı (MyWay CLI), betikler, CI işleri ve yapay zekâ asistanları API’yi bu anahtarla çağırır. Anahtar sahibinin yetkisiyle çalışır; panolardaki rolün neye izin veriyorsa onu yapar, fazlasını yapamaz. İş akışı kuralları, statü kilitleri, doldurma kuralları, oran sınırı ve denetim kaydı tarayıcıdan gelen istekle aynı şekilde uygulanır (v1.82.0).

Anahtar oluşturmak

Anahtarlar Ayarlar > Erişim anahtarları’nda, Kişisel erişim anahtarları kartında yönetilir. Sekme her kullanıcıda vardır, yönetici yetkisi gerekmez. Anahtar adı (örneğin dizüstü, Claude Code), Kapsam ve Geçerlilik seçilip "Anahtar oluştur"a basılır.

• Anahtar yalnız oluşturulduğu anda, "Anahtarın hazır" kutusunda bir kez gösterilir. "Kopyala" ile al ve sakla; kaybedersen iptal edip yenisini oluştur. Sunucu anahtarın kendisini değil yalnız özetini saklar
• Listede her anahtarın adı, kapsamı, oluşturulma ve son geçerlilik tarihi ile son kullanım zamanı ("hiç kullanılmadı" ya da "son kullanım …") görünür. Son kullanım, anahtar kullanıldıkça en çok beş dakikada bir güncellenir
• "İptal et" anahtarı hemen geçersiz kılar: onu kullanan her araç erişimini o anda kaybeder. Sızdığını fark ettiğin okuma ve yazma anahtarını elindeki o anahtarla da iptal edebilirsin; salt okuma anahtarı yalnız tarayıcıdan iptal edilir
• Yeni anahtar yalnız tarayıcıdan oturum açmışken oluşturulur; bir anahtarla başka bir anahtar üretilemez. Böylece sızan bir anahtar kendine yeni ve süresiz bir anahtar açıp iptalden kaçamaz
• Bir kullanıcı en çok 20 anahtar tutabilir. Kullandığın her araç için ayrı anahtar aç: biri sızarsa yalnız onu iptal edersin
• Parolanı değiştirmek anahtarları düşürmez, çünkü anahtar parolanın türevi değil ayrı bir kimlik bilgisidir. Hesabın devre dışı bırakılırsa ise anahtarların hepsi o anda çalışmaz olur
• Oluşturma ve iptal, çalışma alanı yöneticilerinin gördüğü çalışma alanı denetim kaydına "Erişim anahtarı oluşturuldu" ve "Erişim anahtarı iptal edildi" olarak düşer. Anahtarla yapılan işler de denetim kaydında ve görev geçmişinde anahtarın sahibinin adıyla görünür

app.themyway.app/settings/access-tokens

CLI’ı kurmak

CLI tek bir dosyadır (myway.js) ve her kurulum kendi sürümünün CLI’ını kendi adresinden dağıtır; npm gibi dış bir kayda bağlı değildir, internete kapalı ağda da kurulur. Node.js 18 ya da üstü gerekir. Kurulum komutları aynı sekmenin MyWay CLI kartında, macOS / Linux ya da Windows seçilerek kendi sunucunun adresiyle hazır yazılı gelir; aşağıdakiler aynı komutlardır.

# macOS / Linux
mkdir -p ~/.local/bin && curl -fsSL https://myway.company.com/cli/myway.js -o ~/.local/bin/myway && chmod +x ~/.local/bin/myway
myway login --url https://myway.company.com     # asks for the token, it is not shown on screen

# Windows (PowerShell)
New-Item -ItemType Directory -Force "$HOME\myway" | Out-Null
Invoke-WebRequest https://myway.company.com/cli/myway.js -OutFile "$HOME\myway\myway.js"
Set-Content "$HOME\myway\myway.cmd" '@node "%~dp0myway.js" %*'
# once: add it to PATH, then close and reopen PowerShell
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$HOME\myway", "User")
myway login --url https://myway.company.com

• myway login anahtarı gizli sorar ve ~/.config/myway/config.json dosyasına yazar; macOS ve Linux’ta dosyayı yalnız sen okuyabilirsin. myway logout kayıtlı anahtarı unutur; anahtarı sunucuda geçersiz kılmak için ayrıca iptal et
• Birden çok kurulumla çalışıyorsan her biri için ayrı profil açılır: --profile ile seçilir, myway use <profil> varsayılanı değiştirir, myway profiles listeler
• myway whoami bağlı kullanıcıyı, sunucuyu ve sürümleri yazar; CLI’ın sürümü sunucununkinden farklıysa bunu söyler. myway self-update CLI’ı sunucunun dağıttığı sürümle değiştirir. Kurulumu güncelledikten sonra bir kez çalıştırman yeter
• Kendi sertifikasıyla (IP adresi ya da iç CA) çalışan kurulumda Node.js o sertifikaya güvenmelidir: kök sertifikayı NODE_EXTRA_CA_CERTS ortam değişkeniyle göster

Komutlar

Komut adları ve çıktısı İngilizcedir. Adlar kimliğe kendiliğinden çevrilir: pano anahtar önekiyle (MYW), statü, iş tipi, etiket, sprint ve sürüm adıyla (Türkçe harf ve büyük küçük harf farkı yok sayılır), kişi @kullanıcıadı ya da me ile verilir. Her komut --json ile makine okunur çıktı verir; myway help <komut> ayrıntısını, myway help --json bütün komut ve bayrakları yazar.

myway mine                                  # open work assigned to me, all boards
myway tasks --board MYW --status inprogress --label bug
myway task MYW-12                           # details, subtasks, links, comments
myway create --board MYW --title "Login fails on Safari" --type Bug --assignee me --description @notes.md
myway update MYW-12 --due 2026-11-01 --priority high --add-label bug
myway move MYW-12 "In Review"
myway comment MYW-12 "Fixed on staging"
myway start MYW-12                          # assign to me, in progress, git branch MYW-12-<title>
myway pages --board WIKI && myway page pg-abc123

myway start seni görevin atananlarına ekler (var olanlar kalır), panonun ilk "devam ediyor" statüsüne taşır ve bulunduğun git deposunda MYW-12-gorevin-basligi biçiminde bir dal açar ya da varsa ona geçer; --no-branch dalı atlar, --status başka bir hedef statü verir. Dal adında görev anahtarı geçtiği için GitLab entegrasyonu bağlıysa commit ve MR’lar göreve kendiliğinden bağlanır, myway current de o dalın görevini açar.

Çıkış kodları betiklerde kullanılabilir: 0 tamam, 1 hata, 2 kullanım hatası, 3 kimlik (giriş yok ya da anahtar geçersiz), 4 bulunamadı, 5 yetki yok.

Yapay zekâ asistanları

Terminal komutu çalıştırabilen her asistan MyWay’de senin adına iş yapabilir: "bana atananları özetle", "bu hatayı MYW panosuna aç ve bana ata", "PR açıldı, görevi incelemeye al ve yorum yaz" gibi. Asistan tarayıcı açmaz, yalnız CLI’ı kullanır ve senin yetkinle çalışır.

CI ve betikler

Pipeline’da ayar dosyası gerekmez: adres ve anahtar MYWAY_URL ve MYWAY_TOKEN ortam değişkenleriyle verilir, varsayılan pano MYWAY_BOARD ile seçilir. Anahtarı CI’ın gizli değişkenlerinde tut; yalnız okuyan bir iş için salt okuma anahtarı kullan. Betikte CLI yerine doğrudan HTTP de kullanılabilir: istek Authorization: Bearer başlığıyla anahtarı taşır.

# GitLab CI: comment on the task named in the branch once the deploy succeeds
export MYWAY_URL=https://myway.company.com
export MYWAY_TOKEN=$MYWAY_CI_TOKEN          # a masked CI variable
TASK=$(echo "$CI_COMMIT_REF_NAME" | grep -oE "[A-Z][A-Z0-9]*-[0-9]+" | head -1)
if [ -n "$TASK" ]; then myway comment "$TASK" "Deployed to staging: $CI_PIPELINE_URL"; fi

# nightly report with a read-only token
myway tasks --board MYW --status inprogress --json > in-progress.json

İlgili sayfalar: Claude Code ile terminalden çalışmak, GitLab entegrasyonu, Roller & izinler.