A development proxy tool that enables secure tunneling to development endpoints through the Gravity network infrastructure.
Endpoint Client creates a local proxy server that connects to Agentuity's Gravity network, allowing developers to expose local services through secure IPv6 tunnels with automatic certificate generation and network stack management.
- Secure Tunneling: Establishes encrypted connections through Gravity network
- Automatic Certificate Management: Generates and manages TLS certificates
- IPv6 Support: Creates IPv6 addresses using Gravity's network infrastructure
- Development Mode Integration: Seamlessly connects to Agentuity development endpoints
- Network Stack Management: Handles low-level networking with gVisor integration
go build -o endpoint-client .Start the proxy with required organization and project details:
./endpoint-client start \
--orgID "your-org-id" \
--projectID "your-project-id" \
--localPort 3500--orgID(-o): Organization ID--projectID(-pr): Project ID
--localPort(-p): Local port for the proxy (default: 3500)
- Endpoint Discovery: Retrieves development endpoint configuration from Agentuity API
- Network Setup: Creates IPv6 address and finds available proxy port
- Gravity Provisioning: Establishes connection to Gravity network infrastructure
- Certificate Generation: Creates TLS certificates for secure communication
- Proxy Server: Starts local proxy server with network stack integration
- Connection Management: Handles reconnection and graceful shutdown
- Go 1.25.3+
- Cobra CLI for command-line interface
- gVisor for network stack management
- Agentuity Go Common libraries for networking and logging
The project follows standard Go project structure:
main.go: Entry pointcmd/: Command-line interface implementationinternal/stack/: Core networking and proxy functionalityinternal/utils/: Utility functions
Part of the Agentuity development toolchain.