@montage-sh/cli 0.1.0
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 +80 -0
- package/dist/cli.js +225313 -0
- package/dist/cli.js.map +1 -0
- package/package.json +44 -0
package/README.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# @montage-sh/cli
|
|
2
|
+
|
|
3
|
+
Command-line tool for managing Montage prompts. Pull, edit, push, and publish prompts from your terminal.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @montage-sh/cli
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Quick Start
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
# Sign in
|
|
15
|
+
montage login
|
|
16
|
+
|
|
17
|
+
# Link to a project
|
|
18
|
+
montage init
|
|
19
|
+
|
|
20
|
+
# Pull prompts to local files
|
|
21
|
+
montage pull
|
|
22
|
+
|
|
23
|
+
# Edit locally, then push
|
|
24
|
+
montage push
|
|
25
|
+
|
|
26
|
+
# Publish a version
|
|
27
|
+
montage publish customer-support --message "Updated tone"
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Commands
|
|
31
|
+
|
|
32
|
+
| Command | Description |
|
|
33
|
+
|---------|-------------|
|
|
34
|
+
| `montage login` | Authenticate via device-code flow |
|
|
35
|
+
| `montage logout` | Clear local credentials |
|
|
36
|
+
| `montage whoami` | Show active user, org, and project |
|
|
37
|
+
| `montage init` | Link directory to a Montage project |
|
|
38
|
+
| `montage list` | List prompts with status and version |
|
|
39
|
+
| `montage pull` | Download prompts to local files |
|
|
40
|
+
| `montage push` | Upload local changes as draft |
|
|
41
|
+
| `montage publish` | Publish a draft as a live version |
|
|
42
|
+
| `montage status` | Show sync state for all prompts |
|
|
43
|
+
|
|
44
|
+
### Global Flags
|
|
45
|
+
|
|
46
|
+
| Flag | Description |
|
|
47
|
+
|------|-------------|
|
|
48
|
+
| `--json` | Machine-readable JSON output |
|
|
49
|
+
| `--yes` | Skip confirmation prompts (CI mode) |
|
|
50
|
+
| `--project <id>` | Override project from config |
|
|
51
|
+
| `--verbose` | Show debug logs |
|
|
52
|
+
|
|
53
|
+
## CI / CD
|
|
54
|
+
|
|
55
|
+
Use a CLI token for non-interactive pipelines:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
montage login --token $MONTAGE_CLI_TOKEN
|
|
59
|
+
montage push
|
|
60
|
+
montage publish --all --yes --json
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Exit Codes
|
|
64
|
+
|
|
65
|
+
| Code | Meaning |
|
|
66
|
+
|------|---------|
|
|
67
|
+
| 0 | Success |
|
|
68
|
+
| 1 | Command failure |
|
|
69
|
+
| 2 | Validation / usage error |
|
|
70
|
+
| 3 | Auth error |
|
|
71
|
+
| 4 | Conflict detected |
|
|
72
|
+
|
|
73
|
+
## Requirements
|
|
74
|
+
|
|
75
|
+
- Node.js 20 or later (for npm install)
|
|
76
|
+
- A Montage account and project
|
|
77
|
+
|
|
78
|
+
## License
|
|
79
|
+
|
|
80
|
+
MIT
|