Komut başvurusu

Güncellenme: 10 Kasım 2026

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.