USE CASE

Debug CI/CD Failures Interactively

Stop guessing from logs. SSH into failing CI containers, inspect the exact state, and fix issues in minutes instead of hours.

The Problem

Log-based debugging

Scrolling through thousands of log lines hoping to find the needle in the haystack.

Unreproducible failures

The test passes locally but fails in CI. The container is gone before you can inspect it.

Slow feedback loops

Add debug statement, push, wait 20 minutes, repeat. Days lost to simple issues.

How ASD Helps

SSH into Running CI Jobs

Connect to your CI container while it's running. Inspect the exact state when the test failed.

Full Terminal Access

Run commands, check file contents, inspect environment variables. Real debugging, not log archaeology.

Shareable Debug Sessions

Stuck? Share your debug session with a teammate. Two pairs of eyes, same exact environment.

Pause on Failure

Configure your pipeline to pause instead of exit on failure. Debug in the exact failing state.

How It Works

Add ASD to your CI

One line in your pipeline config installs the ASD CLI.

Trigger a tunnel on failure

When a test fails, ASD opens a secure tunnel to the container.

Get notified

Receive a link via Slack, email, or your preferred channel.

Debug interactively

SSH in, inspect the state, fix the issue. All in the browser.

Example: CI Pipeline Integration

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      -  uses: actions/checkout@v4
      -  run: npm ci
      -  run: npm test
      -  name: Debug on failure
        if: failure()
        run: |
          curl -sSL https://install.asd.host | bash
          asd up --token ${{ secrets.ASD_TOKEN }}
          # Terminal exposed at your-subdomain.asd.host/terminal

When a test fails, ASD starts an interactive terminal session and exposes it via tunnel. Access the debugging environment from any browser.

Ready to debug faster?

Start free. No credit card required.