/expose

Create Buddy tunnel for locally running application. Use the tunnel skill for tunnel procedures and options.

Arguments:

• $1: Optional port number (auto-detect if not provided)

Workflow

1. Verify Authentication

Check authentication with:

bdy workspace ls

If fails, inform user: "Run bdy login in a separate terminal (AI agents cannot perform interactive login). See bdy-auth skill for details."

2. Detect Running Service

If port not provided in $1, detect running services on common ports.

Use tools like lsof to find services:

lsof -i -P | grep LISTEN

If multiple services found, ask user which to expose. If no service found, ask user for the port number.

3. Create Tunnel Using Tunnel Skill

Use the tunnel skill procedures to create appropriate tunnel type (HTTP/TCP/TLS).

The tunnel skill contains:

• All tunnel command options
• Security configuration (auth, whitelist)
• Examples for different use cases

4. Display Results

Show:

• Tunnel name and type
• Local endpoint (localhost:port)
• Public URL
• How to stop (Ctrl+C)
• How to save config for reuse

Important Notes

• Applications must bind to 0.0.0.0, not 127.0.0.1
• Tunnels run in foreground by default
• Use bdy tunnel config add to save frequent configurations

Error Handling

If tunnel fails:

• Check app is running on specified port
• Verify app binds to 0.0.0.0
• For auth errors: direct user to run bdy login in separate terminal
• Check logs and tunnel output for specific errors