@braid-cloud/cli 0.1.5 → 0.1.6
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 +40 -1
- package/dist/index.js +1083 -324
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -28,12 +28,22 @@ braid list
|
|
|
28
28
|
|
|
29
29
|
Authenticate with your Braid account. Runs interactive login by default.
|
|
30
30
|
|
|
31
|
+
During login, the CLI now walks you through:
|
|
32
|
+
|
|
33
|
+
1. Signing in with your API key
|
|
34
|
+
2. Launching an interactive scope wizard
|
|
35
|
+
3. Selecting organization/profile/projects with name + ID context
|
|
36
|
+
|
|
37
|
+
Scope defaults are saved to `braid.user.json` so `braid install` can run without repeatedly passing context flags.
|
|
38
|
+
|
|
31
39
|
```bash
|
|
32
40
|
braid auth # Interactive login (alias for `braid auth login`)
|
|
33
41
|
braid auth status # Check auth status
|
|
34
42
|
braid auth logout # Remove stored credentials
|
|
35
43
|
```
|
|
36
44
|
|
|
45
|
+
After a successful login, `braid auth` offers to run `braid scope --file user` so you can pick your defaults from live org/project/profile data.
|
|
46
|
+
|
|
37
47
|
The `login` subcommand accepts:
|
|
38
48
|
|
|
39
49
|
| Flag | Description |
|
|
@@ -96,6 +106,33 @@ braid list # Project-local skills
|
|
|
96
106
|
braid list --global # Global skills only
|
|
97
107
|
```
|
|
98
108
|
|
|
109
|
+
### `braid scope`
|
|
110
|
+
|
|
111
|
+
Interactively choose scope and write either `braid.user.json` or `braid.json`.
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
braid scope # Prompt for target file + scope choices
|
|
115
|
+
braid scope --file user # Force write to braid.user.json
|
|
116
|
+
braid scope --file project # Force write to braid.json
|
|
117
|
+
braid scope --server http://localhost:3211
|
|
118
|
+
|
|
119
|
+
# Non-interactive (script-friendly)
|
|
120
|
+
braid scope --file user --organization personal --source profile --profile default
|
|
121
|
+
braid scope --file project --organization organization --source manual --projects proj_a,proj_b --include-org-global
|
|
122
|
+
braid scope --file user --organization personal --source manual --projects proj_a --rule-ids rule_1,rule_2
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Wizard flow:
|
|
126
|
+
|
|
127
|
+
1. Choose config target (`braid.user.json` or `braid.json`)
|
|
128
|
+
2. Choose organization context (personal or organization)
|
|
129
|
+
3. Choose source (`profile` or `manual`)
|
|
130
|
+
4. In manual mode: choose global toggles, optional project scopes, optional rule include/exclude filters
|
|
131
|
+
5. Select profile/projects/rules by name (with ID hints)
|
|
132
|
+
|
|
133
|
+
Manual mode supports combining global + project scopes together (not either/or).
|
|
134
|
+
When you belong to multiple orgs, the wizard lets you pick which org's projects to browse.
|
|
135
|
+
|
|
99
136
|
### `braid update`
|
|
100
137
|
|
|
101
138
|
Update installed skills to latest versions. Alias: `braid up`
|
|
@@ -147,11 +184,13 @@ For teams, use two config files in your project root:
|
|
|
147
184
|
|
|
148
185
|
```json
|
|
149
186
|
{
|
|
150
|
-
"token": "br_your_personal_token"
|
|
187
|
+
"token": "br_your_personal_token",
|
|
188
|
+
"profile": "coding-standards"
|
|
151
189
|
}
|
|
152
190
|
```
|
|
153
191
|
|
|
154
192
|
This lets teams share configuration while each developer uses their own token.
|
|
193
|
+
`braid auth` can create/update this file for you through its onboarding wizard.
|
|
155
194
|
|
|
156
195
|
### All Config Options
|
|
157
196
|
|