CLI

SecondOS CLI, Bun üzerinde build adımı olmadan çalışır. Repo'nu yapı-farkında bir haritaya senkronlar, ona karşı soruları cevaplar ve kod-DB drift'ini işaretler.

Kurulum

npx ile anında çalıştır ya da projene ekle:

bunx @secondos/cli push .

push · haritayı senkronla

Repo'yu sembollere, imzalara, route'lara ve bir ilişki grafiğine ayrıştırır, ardından haritayı ve embedding'leri yükler. Yeniden-çalıştırmalar bir ayrıştırma önbelleği sayesinde artımlıdır, yani yalnızca değişen yeniden işlenir.

secondos push .            # sync the current repo
secondos push . --deep     # also embed symbol bodies (logic search)

--deep ile gövdeler yerelde okunur ve embed edilir; yalnızca vektör ve satır referansları kalır, kaynak metin asla.

Kod tabanını haritala — secondos scan

secondos scan repo'nu paylaşılabilir, yapı-farkında bir haritaya çevirir: parçalar, nasıl bağlandıkları, hangi servis hangi veriyi yazar ve arkalarındaki kararlar — haritadan üretilir, kaynağından asla. Paylaşımı açarak salt-okunur bir link yayınla. Hesap yok mu? Herkes /scan/try'da prompt'u kendi ajanına kopyalayıp çıktıyı yapıştırarak deneyebilir. Her parçayı düz özellik diliyle yeniden adlandırmak için --narrate ekle.

secondos scan .            # build the shareable map (upload to your project)
secondos scan . --dry-run  # write .secondos/scan.json, upload nothing
secondos scan . --narrate  # rename the parts in plain feature language (needs model creds)
npx @secondos/scan .       # no install: run the same scan from anywhere

ask · çevrimdışı sorgula

Senkronlanmış haritaya karşı bir soru sor. Sözlüksel ve anlamsal getirmeyi kaynaştırır ve cevapları gerçek sembollere ve satır referanslarına dayandırır.

secondos ask "where do we hash passwords?"

drift · şema, env ve bağımlılıklar

Üç salt-okunur kontrol çalıştırır: kodun Drizzle şemasına karşı, kodunun okuduğu ortam değişkenleri (process.env) .env.example'a karşı ve import ettiğin paketler package.json'a karşı. Bildirilmemişleri ve muhtemelen-kullanılmayanları her iki konumuyla raporlar, hiçbir şeyi değiştirmez.

secondos drift            # all three checks; 0 findings on a clean repo

mcp-config · editör kurulumunu yazdır

Cursor, Claude Code, Claude Desktop, Windsurf ve VS Code için yapıştırmaya-hazır MCP yapılandırmasını yazdırır. Onu editörünün MCP ayarlarına kopyala, SecondOS sunucusu kablolanır, elle JSON yazmak yok.

secondos mcp-config       # print config for every supported editor

init-github-action · haritayı taze tut

Her push'ta değişen dosyaları yeniden çıkaran ve bulut haritasını güncelleyen bir GitHub Actions workflow'u iskeletler. Senin CI'ında çalışır, yani kaynağın sınırını asla terk etmez ve harita elle yeniden-senkron olmadan taze kalır.

secondos init-github-action   # write .github/workflows/secondos.yml

docs · yaşayan bilgi tabanını yayınla

Yaşayan dokümanları haritandan, dosya-başı özetlerden ve kabul edilmiş hafızalardan yazar (overview, mimari, modül, API ve veri-modeli dokümanları), kaynak gövdelerini asla (K-S23). Model kimlik bilgileri gerekir. Byte-özdeş dokümanları buluta saklamak için --push ekle, böylece web uygulaması ve read_living_doc MCP aracı onları sunar.

secondos docs .           # write the living docs from the map
secondos docs . --push     # also store them to the cloud (Pro)

Çevrimdışı mod

Tamamen çevrimdışı çalıştırmalar için SECONDOS_EMBEDDER=stub ve SECONDOS_SUMMARIZER=stub ayarla. Harita yine kurulur; yalnızca bulut-destekli embedding ve özet adımları stub'lanır.

MCP sunucusu

Aynı CLI, editörlerini besleyen MCP sunucusunu barındırır. Araçlar ve editör kurulumu için MCP sayfasına bak ya da hızlı başlangıçtan başla.