Skip to content

tunnel_cmd

tunnel_cmd

CLI commands for Cloudflare Tunnel management.

Functions

tunnel 

tunnel(ctx: Context, port: int) -> None

Start a Cloudflare tunnel or manage config.

Source code in src/openjarvis/cli/tunnel_cmd.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
@click.group("tunnel", invoke_without_command=True)
@click.option("--port", default=8000, help="Local port to tunnel.")
@click.pass_context
def tunnel(ctx: click.Context, port: int) -> None:
    """Start a Cloudflare tunnel or manage config."""
    if ctx.invoked_subcommand is not None:
        return
    # Default behavior: start the tunnel
    if not shutil.which("cloudflared"):
        click.echo("Error: cloudflared is not installed.")
        click.echo(
            "Install it from: "
            "https://developers.cloudflare.com/"
            "cloudflare-one/connections/"
            "connect-networks/downloads/"
        )
        sys.exit(1)

    click.echo(f"Starting Cloudflare tunnel to localhost:{port}...")
    click.echo("Press Ctrl+C to stop.\n")

    try:
        subprocess.run(
            [
                "cloudflared",
                "tunnel",
                "--url",
                f"http://localhost:{port}",
            ],
            check=True,
        )
    except KeyboardInterrupt:
        click.echo("\nTunnel stopped.")
    except subprocess.CalledProcessError as e:
        click.echo(f"Tunnel failed: {e}")
        sys.exit(1)

status 

status() -> None

Show current tunnel configuration.

Source code in src/openjarvis/cli/tunnel_cmd.py 
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
@tunnel.command("status")
def status() -> None:
    """Show current tunnel configuration."""
    config_path = DEFAULT_CONFIG_PATH
    if not config_path.exists():
        click.echo("No config file found.")
        return

    content = config_path.read_text()
    if "public_url" in content:
        for line in content.splitlines():
            if "public_url" in line:
                click.echo(f"Configured tunnel URL: {line.split('=', 1)[1].strip()}")
                return
    click.echo("No tunnel URL configured.")

    if shutil.which("cloudflared"):
        click.echo("cloudflared: installed")
    else:
        click.echo("cloudflared: not installed")