CLI kullanımı

Multica CLI'ı kurun ve giriş yapın; terminalden çalışma alanlarını, işleri, agent'ları ve runtime'ları yönetin.

Multica CLI hem yerel runtime'ları bağlar hem de çalışma alanlarını, işleri, agent'ları ve otomasyonları terminalden yönetir. Bu sayfa sık kullanılan yolları kapsar; kurulu sürümünüzün desteklediği bayraklar her zaman ilgili komutun kendi --help'inde tanımlıdır.

Kurulum

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash

Homebrew kuruluysa şunu da çalıştırabilirsiniz:

brew install multica-ai/tap/multica

Windows PowerShell

irm https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.ps1 | iex

Kurulumu doğrulayın:

multica version

İlk bağlantı

Multica Cloud'a bağlanın:

multica setup

Kendi sunucunuzda barındırılan bir örneğe bağlanın:

multica setup self-host \
  --server-url https://api.example.com \
  --app-url https://app.example.com

setup, sunucu adresini kaydeder, girişi tamamlamak için bir tarayıcı açar ve daemon'ı başlatır. Bittiğinde şunu kontrol edin:

multica auth status
multica daemon status

Diğer yapılandırmanın üzerine yazmadan yalnızca yeniden giriş yapmanız gerekiyorsa multica login çalıştırın. Tarayıcısı olmayan bir makinede, önce web ayarlarında bir kişisel erişim token'ı oluşturun, ardından şununla girin:

multica login --token

Komut, token'ın tam değerini kabuk geçmişinin dışında tutmak için sizden terminale yapıştırmanızı ister.

Çalışma alanı seçme

Çalışma alanlarını listeleyin ve varsayılanı değiştirin:

multica workspace list
multica workspace switch <slug>

Sonraki komutlar bu çalışma alanını kullanır. Tek bir komut bunu --workspace-id ile geçersiz kılabilir, ya da MULTICA_WORKSPACE_ID ayarlayabilirsiniz.

Üye davet edin:

multica workspace member invite teammate@example.com
multica workspace member invite admin@example.com --role admin

Sık kullanılan iş işlemleri

# Görüntüle ve ara
multica issue list
multica issue get MUL-123
multica issue search "login failure"

# Oluştur ve güncelle
multica issue create --title "Fix login failure"
multica issue status MUL-123 in_progress
multica issue assign MUL-123 --to "Backend Agent"

# Yorumlar ve çalıştırmalar
multica issue comment list MUL-123
multica issue comment add MUL-123 --content "Check the regression tests first"
multica issue runs MUL-123

Yeni satır ve tırnak işaretleriyle uğraşmamak için uzun açıklamaları veya yorumları stdin'den okuyun:

multica issue create --title "Upgrade notes" --description-stdin < notes.md
multica issue comment add MUL-123 --content-stdin < review.md

Tek bir çalıştırmanın mesajlarını görüntüleyin veya birini durdurun:

multica issue run-messages <task-id> --issue MUL-123
multica issue cancel-task <task-id> --issue MUL-123

Agent'lar ve skill'ler

multica agent list
multica agent get <agent-id>
multica agent create --help
multica agent update <agent-id> --help

multica skill list
multica skill get <skill-id>
multica skill import --url <skill-url>
multica agent skills add <agent-id> --skill-ids <skill-id>

Bir içe aktarma aynı adda bir skill'e denk geldiğinde, varsayılan davranış mevcut içeriği değiştirmeden durmaktır. Niyete göre seçin:

multica skill import --url <skill-url> --on-conflict overwrite
multica skill import --url <skill-url> --on-conflict rename
multica skill import --url <skill-url> --on-conflict skip

overwrite yalnızca skill'in oluşturucusuna izin verilir ve orijinal ID'yi ve agent bağlarını korur.

Daemon ve runtime'lar

multica daemon start
multica daemon stop
multica daemon restart
multica daemon status --output json
multica daemon logs --follow

multica runtime list
multica runtime rename <runtime-id> "Office Mac"
multica runtime usage <runtime-id>
multica runtime activity <runtime-id>

Hâlâ etkin agent'lar bağlı olan bir runtime'ı silmek varsayılan olarak reddedilir. multica runtime delete <id> --cascade bu agent'ların bağını çözer, yapılandırmalarını ve geçmişlerini korur, etkin çalıştırmalarını iptal eder.

Nasıl çalıştığı ve özel profiller için bkz. Daemon ve runtime'lar.

Komut genel bakışı

Komut	Amaç
`issue`	İşleri oluştur, güncelle, ata ve ara; yorumları, aboneleri, etiketleri, özellikleri ve çalıştırmaları yönet
`project`	Projeleri ve kaynaklarını yönet
`label`, `property`	Çalışma alanı etiketlerini ve özel özellikleri yönet
`agent`, `skill`, `squad`	Agent'ları, skill'leri ve ekipleri yönet
`autopilot`	Otomasyonları, tetikleyicileri ve çalıştırma geçmişini yönet
`workspace`	Çalışma alanları oluştur, görüntüle, değiştir ve üye davet et
`repo`	Çalışma alanı depolarını yönet ve yerelde çıkış (checkout) yap
`daemon`, `runtime`	Yerel daemon'ı başlat ve durdur; runtime'ları görüntüle ve yönet
`attachment`	Ekleri yükle veya indir
`user profile`	Geçerli kullanıcının profilini görüntüle veya güncelle
`auth`, `login`, `setup`	Giriş yap, kimlik doğrulama durumunu kontrol et ve bir bağlantı başlat
`config`	Geçerli CLI profilinin yerel yapılandırmasını görüntüle veya düzenle
`update`, `version`	CLI'ı güncelle veya sürümü yazdır

multica chat, bir agent'ın o an ele aldığı dış sohbet oturumunu okur; esas olarak sohbet entegrasyonlarındaki agent'lar içindir, keyfi çalışma alanı konuşmalarına göz atmak için genel bir komut değildir.

Kimlikler ve çıktı biçimleri

İşler MUL-123 gibi anahtarlar veya tam UUID'ler kullanır; kısa UUID önekleri kabul edilmez.

Diğer kaynaklar için list komutları genellikle kopyalanabilir kısa ID'ler yazdırır ve tam UUID için --full-id'i destekler. Kısa bir ID belirsiz olduğunda, CLI daha fazla karakter veya tam UUID ister. Kısa çalıştırma ID'leri, sahip işi belirlemek için ayrıca --issue gerektirir.

Birçok komut yapılandırılmış çıktıyı destekler:

multica issue list --output json
multica agent list --output json

Betikler, terminal odaklı tabloları ayrıştırmak yerine JSON çıktısını kullanmalıdır. Her komutun desteklediği çıktı biçimleri ve sayfalama bayrakları multica <komut> --help ile tanımlanır.

Profiller ve yapılandırma

Varsayılan yapılandırma ~/.multica/config.json'da yaşar. Ayrı bir sunucu adresi, token, varsayılan çalışma alanı ve daemon durumu kümesini izole etmek için --profile <ad> kullanın:

multica setup self-host --profile staging \
  --server-url https://api.staging.example.com \
  --app-url https://app.staging.example.com

multica issue list --profile staging

Adlandırılmış profiller ~/.multica/profiles/<ad>/config.json'da yaşar. Geçerli değerleri inceleyin:

multica config show
multica config show --profile staging

Daemon çalıştıran host kabuğuna, Compose servisine veya container entrypoint'ine MULTICA_DAEMON_PORT ayarlamayın. Host daemon'ı sağlık portunu --profile'dan türetir ve bu değişkeni agent görevlerine kendisi enjekte eder. Değişkeni eski başlangıç ortamlarından tamamen kaldırın: 0.4.22 ve 0.4.23 sürümleri aksi halde o kabuğu yönetilen bir görevle karıştırıp girişi reddeder. Daha yeni sürümler, port tek görev sinyali olduğunda korumalı insan girişinin ve daemon status'un toparlanmasına izin verir; ama olağan API ve profil çözen komutlar değişken kaldırılana kadar bilinçli olarak kapalı-güvenli (fail-closed) kalır.

CLI, daemon tarafından yönetilen bir agent görevi içinde çalıştığında bu insana ait profil dosyalarını yüklemez veya değiştirmez. Multica API komutları, daemon tarafından enjekte edilen görev kapsamlı kimlik bilgisiyle kimlik doğrular. config show ve config set, göreve özel yerel durumu kullanır; login, logout, setup, workspace switch, yerel runtime profil yolu değişiklikleri, daemon start / stop / restart, daemon logs ve daemon probe-runtimes gibi insan/yerel komutlar bu bağlamda kullanılamaz. auth status bu bağlamda token içeriğini yazdırmaz.

daemon status ve daemon disk-usage, bir agent'ın kendisini barındıran runtime'ı, o runtime ile sınırlı olarak inceleyebilmesi için kullanılabilir kalır: status daemon'ın enjekte ettiği sağlık portunu yoklar, disk-usage ise daemon'ın enjekte ettiği çalışma alanları kökünü tarar. İkisi de --profile kabul etmez, disk-usage ayrıca --all-profiles ve --workspaces-root'u reddeder ve STATUS sütunu boş kalır çünkü onu çözmek insanın saklanan token'ını gerektirir. Bu kapsamın dışındaki her şey için du ve df kullanın.

Bu, diğer sağlayıcı araçlarının kullandığı olağan HOME ve XDG değişkenlerini korurken örtük Multica CLI profil çözümlemesini korur. Bir işletim sistemi dosya sistemi sınırı değildir: aynı sistem kullanıcısı olarak çalışan süreçler açıkça bilinen bir yolu yine de açabilir. Bu daha güçlü garanti gerektiğinde özel bir kullanıcı, container, VM veya eşdeğer bir izolasyon kullanın.

CLI yapılandırma dosyaları, Multica'ya siz gibi erişebilen token'lar içerir. Bunları bir depoya commit etmeyin, loglara yüklemeyin veya başkalarıyla paylaşmayın.

Komut referansı

Aşağıdaki tablolar, CLI'ın kendisinin gruplandırdığı şekilde her güncel üst düzey komutu kapsar. Tüm komutlar --server-url, --workspace-id, --profile ve --debug genel bayraklarını kabul eder. --output her komut için ayrı kaydedilir ve varsayılan biçim değişir: list komutları varsayılan olarak bir tablo kullanır, get ve create komutları ise çoğunlukla varsayılan olarak JSON kullanır. Tam bayraklar multica <komut> --help ile tanımlanır.

Çekirdek

Komut	Alt komut	Amaç	Anahtar bayraklar
`issue`	`list`	İşleri listele	`--status`, `--priority`, `--assignee`, `--project`, `--metadata` (tekrarlanabilir), `--property` (tekrarlanabilir, `"Ad=Değer"`; `__none__` ayarsız olanla eşleşir), `--limit`, `--offset`, `--sort` (`property:<ad-veya-id>` dahil), `--full-id`
	`get <id>`	Tek bir işi göster
	`create`	Bir iş oluştur	`--title` (zorunlu), `--description` / `--description-stdin` / `--description-file`, `--status`, `--priority`, `--assignee`, `--parent`, `--stage`, `--project`, `--start-date`, `--due-date`, `--attachment` (tekrarlanabilir)
	`update <id>`	İş alanlarını güncelle	`create` ile aynı alanlar, ayrıca `--position`, `--no-start`
	`assign <id>`	Ata veya atamayı kaldır	`--to` (üyelere, agent'lara ve ekiplere karşı bulanık ad eşleştirme), `--to-id`, `--unassign`, `--no-start`
	`status <id> <status>`	Durumu değiştir	`--no-start`
	`reorder <id>`	Bir sütun içinde taşı
	`search <query>`	İşleri ara	`--limit`, `--include-closed`
	`children <id>`	Alt işleri aşamaya göre gruplanmış listele
	`pull-requests <id>`	Bağlı PR'ları listele
	`comment list/add/delete/resolve/unresolve`	Yorumları yönet	`add`: `--content` / `--content-stdin` / `--content-file`, `--parent`, `--attachment`; `list`: `--since`, `--thread`, `--tail`
	`subscriber list/add/remove <issue-id>`	Aboneleri yönet	`--user`, `--user-id` (varsayılan olarak geçerli kullanıcı)
	`label list/add/remove <issue-id>`	Bir işteki etiketleri yönet
	`metadata list/get/set/delete <issue-id>`	İş düzeyinde anahtar-değer üstverisini yönet
	`property list/set/unset <issue-id>`	Özel özellik değerlerini ayarla	`set`: `--name`, `--value` (`actor` / `multi_actor` bir üye adı, e-posta veya id kabul eder)
	`runs <issue-id>`	Çalıştırma geçmişini görüntüle	`--full-id`
	`run-messages <task-id>`	Tek bir çalıştırmanın mesajlarını görüntüle	`--since`, `--issue`
	`usage <issue-id>`	Toplu token kullanımını görüntüle
	`rerun <id>`	Geçerli atanan için bir çalıştırmayı yeniden kuyruğa al
	`cancel-task <task-id>`	Çalışan veya kuyrukta olan bir çalıştırmayı iptal et	`--issue`
`project`	`list/get/create/update/delete`	Projeleri yönet
	`status <id> <status>`	Proje durumunu değiştir
	`resource list/add/update/remove`	Proje kaynaklarını yönet	`--type`, `--url`, `--local-path`, `--daemon-id`, `--execution-mode` (yerel bir dizin için `in_place` / `worktree`)
`label`	`list/get/create/update/delete`	Çalışma alanı etiketlerini yönet
`property`	`list/get/create/update/archive/unarchive`	Çalışma alanı özel özelliklerini yönet	`create`: `--name`, `--type` (`text`, `number`, `select`, `multi_select`, `date`, `checkbox`, `url`, `actor`, `multi_actor`), `--option` (tekrarlanabilir, yalnızca select tipleri); `list`: `--include-archived`; tip, oluşturmadan sonra değiştirilemez
`agent`	`list/get/create/update/archive/restore`	Agent'ları yönet	`--name`, `--runtime-id` (`create` için zorunlu), `--instructions`, `--model`, `--thinking-level`, `--mcp-config`, `--permission-mode`, `--max-concurrent-tasks`
	`copy <agent-id>`	Yeni bir agent'a kopyala; orijinal dokunulmadan kalır	`--name` (varsayılan olarak orijinal ad artı " (copy)"), `--runtime-id` (başka bir runtime'a kopyalamak `--model`'i de gerektirir), `--no-skills`; `custom_env`, `mcp_config` ve `runtime_config` gibi gizli yapılandırma kopyalanmaz — `create` ile aynı bayraklarla yeniden sağlayın
	`tasks <id>`	Bir agent'ın çalıştırmalarını görüntüle
	`avatar <id>`	Bir avatar yükle
	`env get/set <agent-id>`	Özel ortam değişkenlerini oku ve yaz (yalnızca sahip ve yönetici)
	`skills list/set/add <agent-id>`	Bağlı skill'leri yönet	`--skill-ids` (`set` tüm listeyi değiştirir, `add` ekler)
	`mcp list/add/enable/disable/remove <agent-id>`	Çalışma alanı MCP sunucularını bu agent'a ata	Sunucu id'sini `workspace mcp list`'ten alın. Bir kütüphane girişi buraya eklenene kadar hiçbir şey yapmaz; `disable` atamayı düşürmeden gönderimini durdurur
`autopilot`	`list/get/create/update/delete`	Otomasyonları yönet	`create`: `--title`, `--agent`, `--mode` (hepsi zorunlu), `--project`, `--subscriber` (tekrarlanabilir)
	`trigger <id>`	Bir çalıştırmayı elle tetikle
	`runs <id>`	Çalıştırma geçmişini görüntüle
	`trigger-add/trigger-update/trigger-delete/trigger-rotate-url`	Zamanlama ve webhook tetikleyicilerini yönet
`workspace`	`list/get/create/update/switch`	Çalışma alanlarını yönet; `switch` geçerli profilin varsayılan çalışma alanını ayarlar
	`mcp list/add/update/remove`	Çalışma alanının MCP sunucu kütüphanesini yönet	Yazma işlemleri sahip/yönetici gerektirir. Buraya eklenen bir sunucu hiçbir agent'a atanmaz — `multica agent mcp add` ile bir agent'a verin. `list` yalnızca adları ve taşıma türlerini gösterir; saklanan giriş yalnızca yazılabilir ve asla döndürülmez. `--server-config-file` / `--server-config-stdin` token'ları kabuk geçmişinin dışında tutar
	`member list/invite <email>`	Üyeleri görüntüle, davet gönder	`invite`: `--role` (`member` veya `admin`, varsayılan `member`)
`repo`	`list/add/remove/checkout`	Çalışma alanı depolarını yönet ve yerelde çıkış (checkout) yap	`--url` (tekrarlanabilir); `checkout`: `--ref`
`skill`	`list/get/create/update/delete`	Skill'leri yönet
	`import`	Bir URL'den veya yerel dosyadan skill içe aktar	`--url` / `--file`, `--on-conflict` (`fail`, `overwrite`, `rename`, `skip`; varsayılan `fail`)
	`search <query>`	Skill'leri ara
	`files list/upsert/delete <skill-id>`	Bir skill içindeki dosyaları yönet
`squad`	`list/get/create/update/delete`	Ekipleri yönet (`delete` arşivler)
	`member list/add/set-role/remove`	Ekip üyelerini yönet
	`activity <issue-id> <outcome>`	Bir lider değerlendirmesi kaydet
`chat`	`history`, `thread [id]`	Bir agent'ın o an ele aldığı dış sohbet oturumunu oku	`--limit`, `--before`

Runtime

Komut	Alt komut	Amaç	Anahtar bayraklar
`daemon`	`start`	Yerel daemon'ı başlat	`--foreground`, `--device-name`, `--runtime-name`, `--workspaces-root`, `--poll-interval`, `--heartbeat-interval`, `--agent-timeout` (`0` sınırsız demektir), `--max-concurrent-tasks`, `--no-auto-update`; her birinin karşılığı olan bir `MULTICA_*` ortam değişkeni vardır
	`stop` / `status` / `restart`	Durdur, durumu kontrol et, yeniden başlat (`restart`, `start` ile aynı bayrakları alır)
	`logs`	Daemon günlüklerini görüntüle	`--follow`, `--lines`
	`disk-usage`	Yerel disk kullanımını görüntüle	`--by-workspace`, `--by-task`, `--top`
`runtime`	`list/usage/activity/update/rename/delete`	Runtime'ları görüntüle ve yönet	`delete`: `--cascade` (bağlı agent'ların bağını çözer, verilerini korur ve çalıştırmalarını iptal eder)
	`profile list/create/update/delete`	Özel runtime profillerini yönet
	`profile set-path/unset-path <profile-id>`	Yerel bir çalıştırılabilir dosya yolunu sabitle (yalnızca yerel, sunucuya asla yüklenmez)

Diğer

Komut	Alt komut	Amaç	Anahtar bayraklar
`auth`	`status` / `logout`	Kimlik doğrulama durumunu kontrol et; `logout` yalnızca yerelde kaydedilen token'ı siler, sunucuda iptal etmez
`user`	`profile get/update`	Geçerli kullanıcının profilini görüntüle veya güncelle
`login`	—	Tarayıcı üzerinden giriş yap ve tüm çalışma alanlarını otomatik yapılandır	`--token` (değer verilmeden geçildiğinde terminalde etkileşimli olarak sorar)
`setup`	`cloud` (varsayılan), `self-host`	Sunucu adresini kaydet, girişi tamamla ve daemon'ı başlat	`self-host`: `--server-url`, `--app-url`, `--port`, `--frontend-port`
`attachment`	`download <attachment-id>`, `upload <path>`	Ekleri indir veya yükle	`download`: `--output-dir`; `upload`: `--task`
`config`	`show`, `set <key> <value>`	Geçerli profilin yerel yapılandırmasını görüntüle veya düzenle	Öncelik: komut satırı bayrakları > ortam değişkenleri > `config.json` > yerleşik varsayılanlar; bir değeri temizlemek için boş bir dize ayarlayın
`update`	—	CLI'ı en son sürüme güncelle
`version`	—	Sürüm bilgisini yazdır	`--output` (`text` veya `json`)

Multica'yı başka bir kodlama agent'ından yönetme

İşinizin çoğu zaten Codex, Claude Code veya Cursor içinde geçiyorsa, bir terminale geçmek yerine Multica'yı oradan çalıştırabilirsiniz. Multica CLI skill'i o agent'lara bu sayfadaki komutları güvenli şekilde çalıştırmayı öğretir: token harcamadan işleri ve yorum konularını okuma, bir dosya üzerinden yorum yazma ve bahsetmelerin, durum değişikliklerinin ve atamaların taşıdığı yan etkileri yönetme.

Tamamen kimlik doğrulamalı CLI'ınız üzerinden çalışır ve kendine ait bir erişim eklemez — izinler yine girişinizden, seçili profilinizden ve çalışma alanınızdan gelir. CLI v0.4.26 veya üzeri gerektirir. Depo README'si, Claude Code plugin marketplace'i, Codex skill yükleyicisi, Cursor ve Markdown talimatları yükleyen diğer her araç için kurulumu anlatır.

Sonraki adımlar

Multica CLI skill'i — Multica'yı Codex, Claude Code veya Cursor'dan yönetin.
Kimlik doğrulama ve token'lar — PAT oluşturma, yenileme ve iptal etme.
Sorun Giderme — komut hatalarını ve hiç başlamayan çalıştırmaları teşhis etme.
Agent oluşturma ve yapılandırma — her agent create alanının tam anlamı.

Bu sayfada