MESA Core · v0.9.3

CLI referansı

v0.9.3 kaynak: docs/api-reference.md

Bu rehberin Türkçe ve İngilizce sürümleri aynı konuyu açıklar. Bu sayfayla ilgili kaynak bölümleri en altta yer alır.

Yerel tek kullanıcılı komutlar#

MESA CLI, mesa-memory paketiyle birlikte gelen komut satırı arayüzüdür. Ayrı bir CLI paketi kurmanız gerekmez. v0.9.3 sürümünü kurup yerel sunucuyu başlatın:

v0.9.3 paketi PyPI’da yayımlandı; komut doğrulanan bu sürümü sabitler. Kurulum ve eklere bakın.

bash
pip install mesa-memory==0.9.3
mesa start

Depolama ve kimlik bilgileri otomatik hazırlanır. Bu terminali açık tutup belge komutları için ikinci terminal kullanın.

bash
mesa add document.txt --source file://document.txt
mesa search "archive"
mesa status
mesa mcp-config

mesa delete DOCUMENT_ID, anahtarın yetkileri kapsamında belgeyi siler. Kaynak/çıkarım metinleri temizlenir; denetim durumu ve özetler korunur. Başka bir belgenin sahip olduğu ortak metin kalabilir. mesa mcp-config, API anahtarı yazdırır: çıktısını özel saklayın. Docker’da bu komutları docker compose -f docker-compose.v4.yml exec mesa-v4 ile çalıştırarak volume kimlik bilgilerine erişin.

İleri seviye operatör araçları#

mesa-v4-admin; anahtarları, rolleri ve açık veri kümesi izinlerini yönetir. mesa-v4-rebuild, depolama kökünün tamamını çevrimdışı yeniden oluşturur; mesa-mcp-control, gateway onaylarını yönetir. Bunlar yerel belge komutlarından ayrıdır. Mevcut depolamayı işletmeden önce aşağıdaki sürümle eşleşen parametreleri ve kurtarma kurallarını okuyun.

Etkinleşmeyi bekleme ve kaynakla silme#

mesa add varsayılan olarak ACTIVE durumunu bekler. Etiketli v0.9.3 SDK’sında Mesa.add varsayılanı wait=False değeridir; ACTIVE durumunu beklemek için açıkça wait=True verin. Kabulden hemen sonra dönmek için mesa add document.txt --source file://document.txt --no-wait veya Mesa.add(..., wait=False) kullanın. Terminal parça hatası, mutation ID, durum ve hata sınıfıyla erken bildirilir. RETRY_PENDING terminal durum değildir.

bash
mesa delete --source file://document.txt
mesa delete DOCUMENT_ID
python
from mesa_client import Mesa

with Mesa() as mesa:
    receipt = mesa.add("The archive opens at nine.", source="file://document.txt", wait=True)
    admitted = mesa.add("Another document.", source="file://other.txt", wait=False)
    mesa.delete(source="file://document.txt")

Kimlikle silme korunur. Silme yine sahiplik kapsamını ve purge izinlerini gerektirir.

Dayanak kaynaklar
Kaynak belgedeki ilgili bölümler

Bu bölüm, kaynak belgenin bu sayfayla ilgili kısımlarını değiştirmeden gösterir. Kaynak içindeki bir bölüme giden bağlantıyı açtığınızda metin otomatik olarak görünür.

CLI commands#

The entry points are declared in pyproject.toml. Run `.venv/bin/<command>

--help` after the locked install. These commands do not have a universal

--version; read package metadata with:

bash
.venv/bin/python -c "from importlib.metadata import version; print(version('mesa-memory'))"
CommandScope
mesa-v4-adminOffline credentials and ACL provisioning; defaults to MESA_STORAGE_ROOT/rbac_policy.db
mesa-recoveryTrusted-root checksummed backup, validate and new-root restore
mesa-v4-rebuildOffline full-root projection rebuild/adoption; never an online worker
mesa-mcpDirect V4 stdio server; client tool approval and API key grants, no local control-plane database
mesa-mcp-gatewayIndependently supervised HTTP/Streamable HTTP control gateway
mesa-antigravity-bridgeBinding-scoped stdio bridge with encrypted write spool
mesaCodex/Antigravity install, doctor, profiles, credential lifecycle and operations approvals

Admin bootstrap#

bash
.venv/bin/mesa-v4-admin --help
.venv/bin/mesa-v4-admin grant-role --principal docs-principal --tenant docs-tenant --role OWNER
.venv/bin/mesa-v4-admin grant-agent --principal docs-principal --agent docs-agent --permission SESSION_CREATE

Use these only against the intended stopped/new policy database. issue-key

prints the credential once; rotate-key --key-id revokes/replaces it.

grant-control assigns ADMIN. grant-dataset-permission explicitly assigns

PURGE/ROLLBACK; role inheritance alone does not give those operations.

Dataset role grants require both --workspace and --dataset. Corresponding

revoke-role/revoke-dataset-permission remove authorization.

Recovery, rebuild and MCP#

Use operations and rebuild for safety,

trusted paths, locking, status, retry/lease, exit codes and retained generations.

Never use arbitrary raw-store cleanup as a CLI substitute.

MCP describes binding credentials, encryption and local

operator approval. mesa operations approve/reject acts on durable operation

IDs with server-side ADMIN authority; it does not bypass gateway policy.

python -m mesa_memory.runtime_entrypoint selects the explicit runtime profile;

there is no mesa serve command. mesa-benchmark belongs to the separate

benchmark project and is not installed by this Core package.