gsx-cli 0.1.0

GSX CLI - GoSentrix Application Security CLI. Authenticate once, use everywhere.

GSX CLI

GoSentrix CLI for Application Security. Authenticate once, use everywhere: Claude Code, Cursor, Codex, and more.

Installation

via pip (recommended)

pip install gsx-cli

via npm

npm install -g @gosentrix/gsx

From source

git clone https://github.com/gosentrix/gsx-cli.git
cd gsx-cli
pip install -e .

Quick Start

# 1. Authenticate with GoSentrix (opens browser)
gsx auth login

# 2. Verify setup
gsx doctor

# 3. Configure your IDE
gsx mcp config claude   # For Claude Code
gsx mcp config cursor   # For Cursor
gsx mcp config codex    # For Codex

Commands

Authentication

gsx auth login              # Authenticate via browser (device code flow)
gsx auth status             # Check authentication status
gsx auth logout             # Clear stored credentials
gsx auth print-access-token # Print current access token

MCP Configuration

gsx mcp config <ide>   # Generate MCP config (claude, cursor, codex, generic)
gsx mcp url            # Print MCP endpoint URL
gsx mcp tools          # List available MCP tools
gsx mcp test           # Test MCP connection
gsx mcp call <tool>    # Call an MCP tool directly

Context Management

gsx context show       # Show current workspace/project context
gsx context set        # Set workspace/project scope
gsx context init       # Initialize context for current directory
gsx context clear      # Remove context files

Diagnostics

gsx doctor             # Verify setup and diagnose issues

Claude Code Setup

After authenticating, set up Claude Code with:

# Generate and run the setup command
gsx mcp config claude

This outputs:

claude mcp add --transport http gsx https://mcp.gosentrix.io/mcp \
  --header "Authorization: Bearer $(gsx auth print-access-token)"

claude mcp enable gsx

Environment Variables

Variable	Description	Default
GSX_GATEWAY_URL	MCP Gateway URL	https://mcp.gosentrix.io
GSX_CLIENT_ID	OAuth client ID	gsx-cli

Security

• Device code flow: Secure OAuth authentication via browser
• OS keychain storage: Credentials stored in macOS Keychain, Windows Credential Manager, or Linux Secret Service
• Short-lived tokens: Access tokens expire in 15 minutes
• Automatic refresh: Tokens are refreshed automatically
• Zero credentials in files: Only scope stored in .gsx.json

Requirements

• Python 3.8+
• Node.js 16+ (for npm installation)

License

MIT