// referans

Beş araç,
tek store.

Sıkıştıran araç ile geri getiren araç ayrı olsa da veri tektir. Bu sayfa her aracın ne yaptığını, hangi parametreyi aldığını ve ne zaman kullanılacağını anlatır.

pack · get · read_file ledger · stats MCP native
erişim

MCP araçlarını kullanmak için davet gerekiyor. Discord’da Ekomen77’ye yazıp davet alabilirsin. Davet sayfası →

Beş aracın hepsi tek bir şeyi hedefler: aynı işi daha az token'la yapmak. Faturana etkisini hesapla →

ctx_pack

01

Büyük çıktıyı alır, içeriğe uygun projeksiyon ile sıkıştırır ve bir handle döndürür. Aynı anda ham bloğu store’a yazar; projeksiyonun atladığı her şey handle’da durur.

parametretipaçıklama
textstring · zorunluSıkıştırılacak ham çıktı.
querystring · opsiyonelProjeksiyonu soruya göre keser; ilgili satırlar projeksiyonda kalır.
modeauto · lossless · recoverableProjeksiyon davranışını belirler. Verilmezse auto; içerik neyse projeksiyon o.
örnek
ctx_pack({
  text: buildLog,
  query: "hangi testte timeout var"
})

tip=log
tokens=54813→343  (−%99,4)
handle=79ba5a7c5bde9a4e

Ne zaman: Bir tool çıktısı ~400 token’ı geçtiyse ve tamamı bağlama girmek zorunda değilse. Log, JSON, CSV, test çıktısı, HTML ve transcript aynı kapıdan geçer.

ctx_get

02

Handle’dan tam bir parça getirir. Projeksiyonun kırptığı satırı, JSON alanını ya da kaydı tahmin etmeden okumanın yolu budur.

parametretipaçıklama
handlestring · zorunluctx_pack’in döndürdüğü store anahtarı.
lines"12:18"Satır aralığı; tek satır için "12:12".
grepstringMetin araması; eşleşen satırları döndürür.
json_pointerstringJSON içinde alan yolu: /orders/37/total.
recordnumberYapısal içerikte kayıt indeksi.
context0–20grep eşleşmelerine eklenecek komşu satır sayısı.
örnek
ctx_get({ handle: "79ba5a7c5bde9a4e", lines: "1423:1425" })
ctx_get({ handle: "79ba5a7c5bde9a4e", grep: "timeout", context: 2 })
ctx_get({ handle: "79c98df0f1e0dd32", json_pointer: "/orders/37/total" })

Ne zaman: Projeksiyon bir değeri ima ediyor ama kesin değeri göstermiyorsa. “Hata var” yeterli değilse, hata satırının kendisini çek.

ctx_read_file

03

Bir dosyayı ham haliyle okumak yerine projeksiyonla açar. Büyük log, CSV, HTML veya minified bundle’ı bağlama dökmeden önce ne olduğunu görmek için.

parametretipaçıklama
pathstring · zorunluOkunacak yerel dosya yolu.
örnek
ctx_read_file({ path: "logs/build-2026-11-14.log" })

#projection
lines 8.412 · chars 701.233
levels INFO=... WARN=... ERROR=...
...

Ne zaman: Dosya 500 satır / 20 KB üstündeyse. Tamamını okumak yerine önce şeklini gör; sonra gerekli satırı ctx_get ile çek.

ctx_ledger

04

Uzun bir konuşmayı tipli durum defterine çevirir: hedef, kısıt, karar, başarısızlık, sonraki adım, artifact. “Nerede kalmıştık” sorusunun bağlam maliyetini düşürür.

parametretipaçıklama
transcriptstring · zorunluÖzetlenecek konuşma veya uzun metin.
budgetnumber · opsiyonelDefterin üst sınırı; daha uzun transcript’lerde kesme kararı.
çıktı şekli
goal: ctxc demo sayfasını gerçekçi testlerle kur
constraints: ana sayfa değişmeyecek; tek dosya build yok
decisions: benchmark + round-trip; sayfa başına TOC
failures: smooth scroll test artefaktı
next: diğer alt sayfaların içeriği
artifacts: demo.html, assets/demo-pro.js

Ne zaman: Konuşma uzadı, agent eski kararları unutuyor veya yeni bir oturum aynı işe devam edecekse.

ctx_stats

05

Store muhasebesi: kaç blok var, kaç token kurtarıldı, hangi içerik türü ne kadar kazandırdı. Tasarrufun his değil sayı olduğu yer.

parametretipaçıklama
——Parametre almaz.
örnek çıktı
entries       37
tokens_saved  939.834
tasarruf      log 20 · saved 935.202
              JSON 2 · saved 3.550
              ledger 2 · saved 0
version       1.8.32
remote        local

Ne zaman: Kurulumu doğrulamak, hangi projeksiyon’in işe yaradığını görmek veya bir oturumun gerçekten tasarruf üretip üretmediğini ölçmek için.

Hangisi ne zaman?

durumaraçneden
50 bin token’lık build loguctx_packŞablonlara indir; hata satırlarını koru.
“Hangi istek 500 döndü?”ctx_pack + queryProjeksiyon doğrudan soruya kesilsin.
Projeksiyondaki L1423’ün tamamıctx_get · linesBirebir satır; tahmin yok.
320 siparişlik API yanıtıctx_pack + ctx_getŞema projeksiyonda, kayıt handle’da.
8 bin satırlık dosyactx_read_fileHam okumak yerine projeksiyonla başla.
Uzun agent konuşmasıctx_ledgerKararları ve sonraki adımı taşı.
“Gerçekten tasarruf var mı?”ctx_statsToken farkını tür bazında gör.
davet

Bu araçları MCP üzerinden kullanmak için Discord’da Ekomen77’ye yazıp davet alman gerekiyor. Nasıl alınır →