Komut başvurusu
Her komut konsolity <command> [options] biçiminde yazılır. konsolity help ve konsolity <command> --help yardımı sistemin dilinde gösterir. --json çıktıları kararlıdır ve betikler için tasarlanmıştır; hiçbir zaman gizli bilgi içermez.
Genel bakış
| Komut | Gerekli alan | İşlevi |
|---|---|---|
login |
Makineyi etkinleştirir (Bir makineyi etkinleştirme) | |
setup-token |
CI ve konteynerler için uzun ömürlü bir belirteç oluşturur | |
status |
Hesap, makine, kapsam, geçerlilik süresi, durum | |
hosts |
hosts |
Kapsamdaki sunucular |
run |
hosts, tam erişim |
Bir sunucuda komut çalıştırır |
snippet list |
snippets |
Kapsamdaki parçacıklar |
snippet run |
snippets + hosts, tam erişim |
Bir sunucuda parçacık çalıştırır |
sessions |
sessions |
Hesapta çalışan CLI oturumları |
sessions end |
sessions |
Bir oturumu sonlandırır |
mcp |
mcp |
Claude Code için yerel MCP sunucusu (Yerel MCP) |
serve |
mcp + Claude entegrasyonu |
Claude bağlayıcısının isteklerini işler (Hizmet) |
service install |
serve komutunu sistem hizmeti olarak kurar |
|
rotate |
Makinenin belirtecini yeniler | |
policy |
Uygulanan kapsamı ve kuralları gösterir | |
logout |
Makineyi iptal eder ve yerelde her şeyi siler | |
version |
Sürüm, sistem, mimari | |
update |
İkili dosyayı günceller (imza doğrulanır) |
Kapsam dışındaki bir komut scope_denied, salt okunur bir makinedeki bir komut read_only yanıtını verir.
login
konsolity login [--name <name>] [--scopes hosts,snippets,sessions,mcp] [--read-only]
Makineyi hesabınızdan onaylanan bir kodla etkinleştirir. Ayrıntılar ve örnekler: Bir makineyi etkinleştirme.
setup-token
konsolity setup-token [--name <name>] [--scopes <list>] [--read-only]
login ile aynı akış, ancak herhangi bir şey kaydetmek yerine bir ksetup_... belirtecini yalnızca bir kez gösterir. Ardından belirteci KONSOLITY_TOKEN ile sağlayın. Bkz. setup-token.
status
konsolity status [--json]
Hesabı, makinenin adını ve türünü, kapsamı (alanlar, salt okunur veya tam), geçerlilik süresini, belirtecin yaşını, sunucunun durumunu ve erişilebilir sunucu sayısını gösterir.
$ konsolity status
Account anthony@example.com
Machine build-01 (machine)
Scope hosts, snippets, mcp · full access
Expires on 2027-02-08
Token renewed 3 h ago
Server api.konsolity.com · reachable
Hosts 4
hosts
konsolity hosts [--json]
Kapsamdaki sunucuları listeler: etiket, adres, kullanıcı, grup. Asla parola veya anahtar göstermez.
$ konsolity hosts
web-01 203.0.113.10 deploy Production
web-02 203.0.113.11 deploy Production
db-01 10.0.0.5 admin Data
run
konsolity run <host> [--timeout <seconds>] [--json] -- <command>
Bir sunucuda SSH üzerinden komut çalıştırır: kısa ömürlü özel bağlantı, sabitlenmiş sunucu anahtarı zorunlu, terminalde canlı çıktı, uzak komutun çıkış kodu konsolity komutunun çıkış kodu olarak aktarılır. <host>, sunucunun etiketi veya tanımlayıcısıdır. -- işaretinden sonraki her şey olduğu gibi komuttur.
| Seçenek | İşlevi |
|---|---|
--timeout <seconds> |
Komutun zaman aşımı; makinenin azami zaman aşımıyla sınırlıdır (varsayılan 60 sn). |
--json |
Sonunda tek bir JSON çıktısı: exit_code, stdout, stderr, duration_ms. |
$ konsolity run web-01 -- systemctl status nginx
● nginx.service - A high performance web server
Active: active (running) since Mon 2026-11-09 08:12:44 UTC
$ echo $?
0
CLI, komutu çalıştırmadan önce kapsamı ve kuralları denetler, ardından başlangıcı günlüğe yazar: bu yazma başarısız olursa komut çalıştırılmaz. Yıkıcı bir komut onayınızı bekler:
$ konsolity run db-01 -- "mysql -e 'DROP TABLE sessions_old'"
Destructive command: confirmation requested in the Konsolity app.
https://app.konsolity.com/cli/confirm/9f3c2a71
Waiting (5 min at most)...
Allowed. Running.
snippet
konsolity snippet list [--json]
konsolity snippet run <snippet> <host> [--timeout <seconds>] [--json]
snippet list kapsamdaki parçacıkları (ad, grup) gösterir. snippet run, bir parçacığı kasada kaydedildiği gibi kapsamdaki bir sunucuda çalıştırır. <snippet>, parçacığın adı veya tanımlayıcısıdır. run ile aynı kurallar geçerlidir: günlük, içerik yıkıcıysa onay, aktarılan çıkış kodu.
$ konsolity snippet run "Clear the cache" web-01
Cache cleared.
sessions
konsolity sessions [--follow] [--json]
konsolity sessions end <id>
Hesapta çalışan CLI oturumlarını listeler: makine, komut, ne zamandan beri. --follow listeyi açık tutar ve yeniler. sessions end <id> bir oturumu sonlandırır: ilgili komut 5 saniyeden kısa sürede durdurulur.
$ konsolity sessions
a1b2c3 build-01 run web-01: tail -f /var/log/nginx/access.log for 12 min
d4e5f6 laptop mcp for 1 h
$ konsolity sessions end a1b2c3
mcp
konsolity mcp
Claude Code'a bağlanmak üzere yerel bir stdio MCP sunucusu başlatır:
claude mcp add konsolity -- konsolity mcp
Araçların ve sınırların ayrıntıları: Claude Code için yerel MCP.
serve
konsolity serve
Hesabın Claude bağlayıcısının (claude.ai, Claude uygulaması) isteklerini masaüstü uygulaması gibi, ancak arayüz olmadan, kapsam ve kurallar dahilinde işler. mcp alanını ve Studio planının Claude entegrasyonunu gerektirir. Ön planda kalır; bir sunucu için hizmet olarak kurun.
service install
sudo konsolity service install
konsolity serve komutunu sistem hizmeti olarak (systemd, launchd veya Windows zamanlanmış görevi) kurar. Bkz. Hizmet ve depolama.
rotate
konsolity rotate
Makine belirtecinin yenilenmesini zorlar. Yenileme zaten her 24 saatte bir otomatik olarak yapılır. Makine anahtarı değişmez.
policy
konsolity policy [--json]
Makinenin gerçekte uyguladıklarını gösterir: alanlar, salt okunur veya tam, sunucular, parçacıklar, komut kuralları, “Herhangi bir komut”, azami zaman aşımı.
logout
konsolity logout
Makineyi sunucuda iptal eder, ardından belirteci, makine anahtarını ve yerel kopyaları siler. Makineyi yeniden kullanmak için yeni bir etkinleştirme gerekir.
version
konsolity version
Sürümü, sistemi ve mimariyi gösterir.
update
konsolity update
En son sürümü indirir, SHA-256 özetini ve bildirimin Ed25519 imzasını doğrular, ardından ikili dosyayı değiştirir. apt, dnf veya Homebrew ile kurulduğunda CLI sizi bu yöneticiye yönlendirir.
Ortam değişkenleri
| Değişken | İşlevi |
|---|---|
KONSOLITY_TOKEN |
Uzun ömürlü ksetup_... belirteci (CI, konteynerler). Kaydedilmiş gizli bilgilerin yerini alır. |
Çıkış kodları
| Kod | Anlamı |
|---|---|
0 |
Başarılı. |
| uzak kod | run ve snippet run, uzak komutun çıkış koduyla çıkar (örneğin komut sunucuda başarısız olduysa 1). |
1 |
Genel hata: makine etkinleştirilmemiş, ağa ulaşılamıyor, sunucu ya da snippet bulunamadı, günlük satırı yazılamadı (komut bu durumda başlatılmaz), yerel gizli bilgiler okunamıyor. |
2 |
Kullanım hatası: bilinmeyen seçenek, eksik ya da çok uzun komut (en fazla 4.000 karakter), geçersiz KONSOLITY_TOKEN. |
3 |
Ret: alan kapsamda yok (scope_denied), salt okunur makine (read_only), hiçbir kural eşleşmiyor (denied), kurallar eksik (policy_missing), plan gerekli (plan_required) ya da etkinleştirme reddedildi. |
4 |
Yıkıcı komut onaylanmadı: uygulamada ya da konsolda reddedildi veya 5 dakika içinde yanıt verilmedi. Komut başlatılmadı. |
77 |
Makine iptal edildi, süresi doldu veya başka bir bilgisayardan kullanıldı (farklı parmak izi) ya da oturum uygulamadan veya konsoldan sonlandırıldı: bağlantılar kesilir ve komut durdurulur. Basit bir oturum sonlandırma dışında yerel gizli bilgiler de silinir. |