@scheduler-systems/gal-cli 0.1.2

package/LICENSE

@@ -0,0 +1,14 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2025 Scheduler Systems. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary and confidential property of Scheduler Systems.
+
+UNAUTHORIZED COPYING, MODIFICATION, DISTRIBUTION, OR USE OF THIS SOFTWARE,
+VIA ANY MEDIUM, IS STRICTLY PROHIBITED.
+
+This Software is licensed, not sold. Scheduler Systems retains all rights,
+title, and interest in and to the Software.
+
+For licensing inquiries, contact: support@scheduler.systems

package/README.md

@@ -0,0 +1,157 @@
+# GAL CLI
+
+Command-line tool for managing AI agent configurations across your organization.
+
+**PROPRIETARY SOFTWARE** - Internal use only.
+
+## Installation
+
+```bash
+# Configure npm to use GitHub Packages for @scheduler-systems scope
+npm config set @scheduler-systems:registry https://npm.pkg.github.com
+
+# Authenticate with GitHub Packages (use your GitHub token)
+npm login --registry=https://npm.pkg.github.com
+
+# Install the CLI
+npm install -g @scheduler-systems/gal-cli
+```
+
+## Quick Start
+
+```bash
+# Configure your GAL API endpoint
+gal config set apiUrl https://api.gal.dev
+gal config set defaultOrg your-org-name
+
+# Fetch agent configurations
+gal fetch
+
+# Scan a repository
+gal scan owner/repo
+```
+
+## Commands
+
+### `gal fetch [orgName]`
+
+Download agent configurations from GAL API.
+
+```bash
+gal fetch                      # Fetch for default org
+gal fetch my-org               # Fetch for specific org
+gal fetch --platform claude    # Filter by platform
+gal fetch --json               # Output as JSON
+gal fetch --dry-run            # Preview without writing
+gal fetch list                 # List available organizations
+```
+
+### `gal config`
+
+Manage CLI configuration.
+
+```bash
+gal config set apiUrl https://api.gal.dev
+gal config set defaultOrg my-org
+gal config show
+gal config reset
+```
+
+### `gal sync`
+
+Sync local configurations to governance repository.
+
+```bash
+gal sync              # Sync all local configs
+gal sync --dry-run    # Preview changes
+```
+
+### `gal run <command>`
+
+Execute slash commands headlessly (for CI/CD).
+
+```bash
+gal run --list                    # List available commands
+gal run my-command "arguments"    # Run a command
+gal run my-command --dry-run      # Preview without executing
+gal run my-command --json         # Get JSON output
+gal run --file ./cmd.md "args"    # Run from file path
+```
+
+### `gal sandbox`
+
+E2B sandbox operations for safe testing.
+
+```bash
+gal sandbox start                           # Start sandbox session
+gal sandbox exec "echo hello"               # Execute code
+gal sandbox validate ./path/to/config.json  # Validate config
+```
+
+### `gal scan <repo>`
+
+Scan a GitHub repository for AI agent configurations.
+
+### `gal analyze`
+
+Analyze configurations for security issues.
+
+## Environment Variables
+
+```bash
+# Required
+GITHUB_TOKEN=your_github_token
+
+# Optional - E2B Sandbox
+E2B_API_KEY=your_e2b_api_key
+
+# Optional - Session Analysis with LLM
+GAL_SESSION_ANALYSIS_ENABLED=true
+GAL_LLM_PROVIDER=anthropic          # or 'openai'
+ANTHROPIC_API_KEY=your_key          # for Anthropic
+OPENAI_API_KEY=your_key             # for OpenAI
+```
+
+## Supported Platforms
+
+- Claude Code (`.claude/`)
+- Cursor (`.cursor/`)
+- Google Gemini (`.gemini/`)
+- OpenAI Codex (`.codex/`)
+- Windsurf (`.windsurf/`)
+
+## CI/CD Integration
+
+```yaml
+- name: Install GAL CLI
+  run: npm install -g gal-cli
+
+- name: Fetch configs
+  run: gal fetch --json > configs.json
+```
+
+## Session Analysis
+
+When enabled, the CLI tracks commands during your session and provides LLM-powered analysis at the end:
+- Command success/failure tracking
+- Error analysis and recommendations
+- Session insights
+
+## Development
+
+```bash
+# Clone the monorepo
+git clone https://github.com/Scheduler-Systems/gal.git
+cd gal/apps/cli
+
+# Install and build
+npm install
+npm run build
+
+# Development mode
+npm run dev
+```
+
+## License
+
+Proprietary - Copyright (c) 2025 Scheduler Systems. All rights reserved.