@getmagical/cli 0.2.4 → 0.2.5
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 +36 -0
- package/dist/index.js +1707 -544
- package/dist/index.js.map +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -21,6 +21,42 @@ mgcl automation-runs list --automation-id ...
|
|
|
21
21
|
mgcl automations run-draft --draft-automation-id ... --agent-id ... --idempotency-key ... --config-json '{"startInTakeOverMode":true,"captureActions":true,"approvalMode":"HUMAN_APPROVAL","consistencyCheckCount":3}'
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
+
## Edit a Skill
|
|
25
|
+
|
|
26
|
+
The Skills working-copy commands currently support root-level skills at
|
|
27
|
+
`skills/<skill-name>`:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
mgcl skills pull review
|
|
31
|
+
# Edit ./skills/review in your editor.
|
|
32
|
+
mgcl skills diff review
|
|
33
|
+
mgcl skills push review --message "Improve review guidance"
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
`pull` downloads the complete skill directory from the repository's default
|
|
37
|
+
branch and remembers the pulled contents. Tags, commit SHAs, and non-default
|
|
38
|
+
branches remain available through the low-level read/history commands, but are
|
|
39
|
+
not supported by the writable working-copy workflow.
|
|
40
|
+
It refuses to overwrite existing files or local edits unless you pass `--force`.
|
|
41
|
+
`diff` compares your files with the pulled contents. `push` sends all
|
|
42
|
+
additions, edits, and deletions as one commit against the current repository
|
|
43
|
+
head. After a successful push, the working copy and its remembered baseline
|
|
44
|
+
are replaced with the committed bundle read back at the new commit, so they
|
|
45
|
+
include any concurrent change to another file in the same skill. If that
|
|
46
|
+
refresh fails, the push still succeeded; re-run
|
|
47
|
+
`mgcl skills pull <skill> --force` to sync.
|
|
48
|
+
|
|
49
|
+
These commands do not protect concurrent edits to the same skill. If the skill
|
|
50
|
+
changed remotely and your local patch no longer applies, `push` fails and asks
|
|
51
|
+
you to pull the latest version and reapply your changes. Binary file changes
|
|
52
|
+
cannot be pushed.
|
|
53
|
+
|
|
54
|
+
These commands use temporary Git repositories only; they do not initialize or
|
|
55
|
+
modify Git state in the directory where you run `mgcl`.
|
|
56
|
+
|
|
57
|
+
For low-level automation, `mgcl skills apply-patch` applies one raw Git patch
|
|
58
|
+
as a single commit.
|
|
59
|
+
|
|
24
60
|
## Local Development
|
|
25
61
|
|
|
26
62
|
Run the CLI from source without building:
|