Docs · v0.1

Yelt in sixty seconds.

One command, one file, every agent host on your machine. Full handbook is in flight; this page covers what works today.

npx @yelt-ai/yelt init

Commands

  • yelt init

    Sign in via the browser and write SKILL.md into every detected agent host on this machine. Re-run any time to refresh.

  • yelt sync

    Re-fetch the latest policies and re-write SKILL.md using the saved token. Idempotent — skips writes when bytes are identical.

  • yelt watch

    Poll the dashboard every 30 seconds and re-sync whenever your policies change. Override the interval with YELT_WATCH_INTERVAL_MS.

  • yelt whoami

    Show the signed-in account and the host directories the CLI will write to.

  • yelt logout

    Clear ~/.yelt/auth.json. Sign in again with yelt init when you're ready.

Where SKILL.md lands

The CLI detects which agent hosts are installed locally and writes only to the directories that exist. Re-running picks up new hosts you've installed since.

  • Claude Code~/.claude/skills/yelt.md
  • Cursor~/.cursor/skills/yelt.md
  • Codex~/.codex/skills/yelt.md
  • Cline~/.cline/skills/yelt.md

Environment

  • YELT_APP_URL

    Override the API origin (default https://yelt.ai). Useful for local dev: YELT_APP_URL=http://localhost:3000 npx @yelt-ai/yelt init

  • YELT_WATCH_INTERVAL_MS

    yelt watch poll interval in milliseconds. Default 30000.

Architecture handbook

The full docset — policy IR, audit hash chain, gateway protocol, compliance mappings — is a work in progress. Until it's published, the source of truth lives in the repo and the team answers questions directly.