@scheduler-systems/gal-cli 0.1.12 → 0.1.13-alpha.pr266
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -136
- package/dist/index.cjs +602 -68
- package/package.json +9 -9
- package/scripts/postinstall.cjs +171 -11
- package/scripts/preuninstall.cjs +149 -0
package/README.md
CHANGED
|
@@ -1,159 +1,40 @@
|
|
|
1
1
|
# GAL CLI
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Sync your organization's approved AI agent configurations.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
## Installation
|
|
5
|
+
## Install
|
|
8
6
|
|
|
9
7
|
```bash
|
|
10
|
-
# Configure npm to use GitHub Packages for @scheduler-systems scope
|
|
11
|
-
npm config set @scheduler-systems:registry https://npm.pkg.github.com
|
|
12
|
-
|
|
13
|
-
# Authenticate with GitHub Packages (use your GitHub token)
|
|
14
|
-
npm login --registry=https://npm.pkg.github.com
|
|
15
|
-
|
|
16
|
-
# Install the CLI
|
|
17
8
|
npm install -g @scheduler-systems/gal-cli
|
|
18
9
|
```
|
|
19
10
|
|
|
20
|
-
##
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
# Configure your GAL API endpoint
|
|
24
|
-
gal config set apiUrl https://api.gal.dev
|
|
25
|
-
gal config set defaultOrg your-org-name
|
|
26
|
-
|
|
27
|
-
# Fetch agent configurations
|
|
28
|
-
gal fetch
|
|
29
|
-
|
|
30
|
-
# Scan a repository
|
|
31
|
-
gal scan owner/repo
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
## Commands
|
|
35
|
-
|
|
36
|
-
### `gal fetch [orgName]`
|
|
37
|
-
|
|
38
|
-
Download agent configurations from GAL API.
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
gal fetch # Fetch for default org
|
|
42
|
-
gal fetch my-org # Fetch for specific org
|
|
43
|
-
gal fetch --platform claude # Filter by platform
|
|
44
|
-
gal fetch --json # Output as JSON
|
|
45
|
-
gal fetch --dry-run # Preview without writing
|
|
46
|
-
gal fetch list # List available organizations
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### `gal config`
|
|
50
|
-
|
|
51
|
-
Manage CLI configuration.
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
gal config set apiUrl https://api.gal.dev
|
|
55
|
-
gal config set defaultOrg my-org
|
|
56
|
-
gal config show
|
|
57
|
-
gal config reset
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
### `gal sync`
|
|
61
|
-
|
|
62
|
-
Sync local configurations to governance repository.
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
gal sync # Sync all local configs
|
|
66
|
-
gal sync --dry-run # Preview changes
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### `gal run <command>`
|
|
70
|
-
|
|
71
|
-
Execute slash commands headlessly (for CI/CD).
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
gal run --list # List available commands
|
|
75
|
-
gal run my-command "arguments" # Run a command
|
|
76
|
-
gal run my-command --dry-run # Preview without executing
|
|
77
|
-
gal run my-command --json # Get JSON output
|
|
78
|
-
gal run --file ./cmd.md "args" # Run from file path
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### `gal sandbox`
|
|
82
|
-
|
|
83
|
-
E2B sandbox operations for safe testing.
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
gal sandbox start # Start sandbox session
|
|
87
|
-
gal sandbox exec "echo hello" # Execute code
|
|
88
|
-
gal sandbox validate ./path/to/config.json # Validate config
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
### `gal scan <repo>`
|
|
92
|
-
|
|
93
|
-
Scan a GitHub repository for AI agent configurations.
|
|
94
|
-
|
|
95
|
-
### `gal analyze`
|
|
96
|
-
|
|
97
|
-
Analyze configurations for security issues.
|
|
98
|
-
|
|
99
|
-
## Environments
|
|
100
|
-
|
|
101
|
-
The CLI supports multiple environments via npm tags and API configuration:
|
|
102
|
-
|
|
103
|
-
| Environment | npm Tag | Default API | Install Command |
|
|
104
|
-
|-------------|---------|-------------|-----------------|
|
|
105
|
-
| **Production** | `latest` | `https://api.gal.run` | `npm install -g @scheduler-systems-ai/gal-cli` |
|
|
106
|
-
| **Staging** | `beta` | `https://api.gal.run` | `npm install -g @scheduler-systems-ai/gal-cli@beta` |
|
|
107
|
-
| **Development** | local | `http://localhost:3000` | `pnpm build && npm link` |
|
|
108
|
-
|
|
109
|
-
### Using Staging Environment
|
|
11
|
+
## Usage
|
|
110
12
|
|
|
111
13
|
```bash
|
|
112
|
-
#
|
|
113
|
-
|
|
14
|
+
# Login with GitHub
|
|
15
|
+
gal auth login
|
|
114
16
|
|
|
115
|
-
#
|
|
116
|
-
GAL_API_URL=https://gal-api-wug5dzqj2a-uc.a.run.app gal sync --pull
|
|
117
|
-
|
|
118
|
-
# Option 3: Persistent configuration
|
|
119
|
-
gal config set apiUrl https://gal-api-wug5dzqj2a-uc.a.run.app
|
|
17
|
+
# Pull approved configs
|
|
120
18
|
gal sync --pull
|
|
121
19
|
```
|
|
122
20
|
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
| Service | URL |
|
|
126
|
-
|---------|-----|
|
|
127
|
-
| API | `https://gal-api-wug5dzqj2a-uc.a.run.app` |
|
|
128
|
-
| Dashboard | `https://gal-staging-dashboard.web.app` |
|
|
129
|
-
| Website | `https://gal-staging.web.app` |
|
|
130
|
-
|
|
131
|
-
## Environment Variables
|
|
21
|
+
## Help
|
|
132
22
|
|
|
133
23
|
```bash
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
# Required
|
|
138
|
-
GITHUB_TOKEN=your_github_token
|
|
24
|
+
gal --help
|
|
25
|
+
```
|
|
139
26
|
|
|
140
|
-
|
|
141
|
-
E2B_API_KEY=your_e2b_api_key
|
|
27
|
+
## Documentation
|
|
142
28
|
|
|
143
|
-
|
|
144
|
-
GAL_SESSION_ANALYSIS_ENABLED=true
|
|
145
|
-
GAL_LLM_PROVIDER=anthropic # or 'openai'
|
|
146
|
-
ANTHROPIC_API_KEY=your_key # for Anthropic
|
|
147
|
-
OPENAI_API_KEY=your_key # for OpenAI
|
|
148
|
-
```
|
|
29
|
+
https://gal.run/docs
|
|
149
30
|
|
|
150
|
-
|
|
31
|
+
### Supported Platforms
|
|
151
32
|
|
|
152
|
-
- Claude Code (`.claude/`)
|
|
153
|
-
- Cursor (`.cursor
|
|
154
|
-
- Google Gemini (`.gemini/`)
|
|
155
|
-
- OpenAI Codex (`.codex/`)
|
|
156
|
-
- Windsurf (`.windsurf/`)
|
|
33
|
+
- Claude Code (`.claude/`) - Full support
|
|
34
|
+
- Cursor (`.cursor/`, `.cursorrules`) - Full support including legacy `.cursorrules` file
|
|
35
|
+
- Google Gemini (`.gemini/`) - Planned
|
|
36
|
+
- OpenAI Codex (`.codex/`) - Planned
|
|
37
|
+
- Windsurf (`.windsurf/`) - Planned
|
|
157
38
|
|
|
158
39
|
## CI/CD Integration
|
|
159
40
|
|