Get started

Quickstart

Install via your CLI, login, and ask your agent a question. Your entire network will be visible in under a minute. Let’s get started.

  1. Install yeet

    One command installs the CLI and the yeetd daemon on a Linux host and starts the daemon:

    curl -fsSL https://yeet.cx | sh

    yeet runs on Linux. On macOS or Windows, run it in Docker. Or Manual install.

  2. Sign the host in

    Signing in ties the host to your account. It prints a link to open in your browser:

    yeet login

  3. Explore your network

    Open your coding agent on the host (Claude Code, Codex, etc). Start with yeet graph dump, which shows everything yeet can read on the host, then ask about the network. For example:

    Run yeet graph dump, then show me a report on my system health, and if anything looks out of place.

  4. Start building

    Ask about an app, a bug, or any network traffic. Turn it into a grafana dashboard or a local web app in your browser.

    A great place to start is with a tool from our library. HTTP Scope shows the live web requests going in and out of a machine. Here’s the prompt:

    Spin up https://github.com/yeet-src/httpscope

    2-minute build time

  5. Keep it running

    yeet can run as a service that restarts on its own, posts to Slack when something trips, or exports metrics to Prometheus and Grafana. Just ask:

    Use yeet to see which of my containers talk to each other, and which ones go out to the internet. Show me who talks to whom and how much. Make it a Grafana dashboard, I already have Prometheus.

    Use yeet to see if Jellyfin is actually transcoding on my GPU. Show me every transcode: fully on GPU, mixed, or software. How much CPU each one uses and how fast it reads the file from storage. Build your own dashboard with https://github.com/yeet-src/yeetkit