GL Connectors CLI

A command-line interface for managing GL Connectors integrations and authentication.

Prerequisites

Installation

Install the CLI using:

pip install gl-connectors-cli

Quick Start

Get up and create your first integration using GL Connectors CLI:

1. Login:

   glcon auth login
   # Make sure you have access to GL Connectors playground environment.
   # You will be prompted to enter:
   
   # Client API Key: sk-client-...
   # Username (User Identifier): your user identifier
   # User Secret: sk-user-...
   

2. View Available Integrations:

   glcon integrations
   

   You should have 0 integration(s) count for each connector listed.

3. Add Your First Integration:

   glcon integrations add github
   

   You should see the following message:

   ✓ OAuth flow initiated for github!
   Please visit the following URL to complete the integration:
   https://github.com/login/oauth/authorize?client_id=...
   

   Open the URL in your browser and follow the OAuth flow.

4. Check your GitHub accounts:

   After you have completed the OAuth flow, you can check your GitHub accounts.

   glcon integrations show github
   

   Voila! You should see your GitHub accounts listed, as shown below:

   Integrations for github
   =======================
   ℹ Found 1 integration(s)
   
   User Identifier | Status
   ------------------------------------
   | your-github-username | ✓ Selected
   

That's it! You're now ready to manage your GL Connectors' integrations.

Command Reference

Authentication Commands

Login prompts:

• Client API Key: Your client API key (input hidden)
• Username: Your user identifier
• User Secret: Your user secret (input hidden)

Configuration Options:

• --api-url: Custom Connector URL (for development purposes)

Integration Commands

Examples:

glcon integrations                           # List all connectors
glcon integrations add github                # Add GitHub integration
glcon integrations show google               # Show all Google accounts
glcon integrations show google user@gmail.com  # Show specific account details
glcon integrations remove github username    # Remove GitHub integration
glcon integrations select google user@gmail.com # Set as primary Google account

User Commands

Example:

glcon users create john.doe@example.com

Important: Save the user secret securely! It's only shown once.

Configuration

The CLI stores configuration in ~/.connector/config.json. This file contains:

• Authentication session (client key, user token, API URL)
• Session expiration information

The API URL is only configurable during authentication using the --api-url flag.

Getting Help

Get help for any command:

glcon --help                    # Main help
glcon auth --help              # Authentication commands help
glcon integrations --help      # Integration commands help
glcon users --help             # User management commands help

Available Connectors

The available connectors depend on your Connector configuration. Common connectors include:

• github: GitHub API integration
• google: Google services integration
• google_drive: Google Drive integration
• google_docs: Google Docs integration
• google_mail: Google Mail integration

Contributing

We welcome contributions! Please see our documentation:

• CONTRIBUTING.md - Development setup, workflow, and code review guidelines
• constitution.md - Code generation standards

License

This project is maintained by the GL Connectors Team.