@capgo/cli 7.84.10 → 7.86.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.
Files changed (20) hide show
  1. package/README.md +4 -1
  2. package/dist/index.js +304 -303
  3. package/dist/package.json +10 -3
  4. package/dist/src/build/credentials-command.d.ts +1 -0
  5. package/dist/src/github-command.d.ts +9 -0
  6. package/dist/src/github.d.ts +6 -0
  7. package/dist/src/schemas/build.d.ts +3 -0
  8. package/dist/src/schemas/sdk.d.ts +1 -0
  9. package/dist/src/sdk.d.ts +2 -2
  10. package/dist/src/sdk.js +216 -216
  11. package/dist/src/utils/safeWrites.d.ts +2 -2
  12. package/dist/src/utils.d.ts +7 -1
  13. package/package.json +10 -3
  14. package/skills/_artifacts/domain_map.yaml +32 -0
  15. package/skills/_artifacts/skill_spec.md +30 -0
  16. package/skills/_artifacts/skill_tree.yaml +17 -0
  17. package/skills/native-builds/SKILL.md +177 -0
  18. package/skills/organization-management/SKILL.md +93 -0
  19. package/skills/release-management/SKILL.md +222 -0
  20. package/skills/usage/SKILL.md +89 -0
package/skills/usage/SKILL.md ADDED
@@ -0,0 +1,89 @@
1
+ ---
2
+ name: usage
3
+ description: Use when operating the Capgo CLI for app setup, OTA bundles, channels, organizations, encryption keys, account lookups, MCP integration, GitHub support commands, and native cloud builds.
4
+ ---
5
+
6
+ # Capgo CLI Usage
7
+
8
+ Use this skill as the entry point for the Capgo CLI skill set.
9
+
10
+ TanStack Intent skills should stay focused and under the validator line limit, so the Capgo CLI guidance is split into multiple skills:
11
+
12
+ - `usage`: high-level command routing, shared invocation rules, and quick command selection.
13
+ - `release-management`: OTA bundle, channel, and encryption-key workflows.
14
+ - `native-builds`: native cloud build request and build-credential workflows.
15
+ - `organization-management`: organization, account, and deprecated organisation-alias workflows.
16
+
17
+ ## Shared invocation rules
18
+
19
+ - Prefer `npx @capgo/cli@latest ...` in user-facing examples to match existing docs and CLI output.
20
+ - Many commands can infer `appId` and related config from the current Capacitor project.
21
+ - Shared public flags commonly include `-a, --apikey <apikey>` and `--verbose` on commands that support verbose output.
22
+
23
+ ## Use this skill for quick routing
24
+
25
+ ### Project setup and diagnostics
26
+
27
+ - `init [apikey] [appId]`: guided first-time setup for Capgo in a Capacitor app. In interactive use, onboarding can also offer a final `npx skills add https://github.com/Cap-go/capgo-skills -g -y` install step before the GitHub support prompt; if accepted, the support menu includes `Cap-go/capgo-skills` alongside the updater-only and all-Capgo choices. If iOS sync validation fails during onboarding, the CLI can offer to run a one-line native reset command, wait for you to type `ready` after a manual fix, and offer cancellation every third failed retry.
28
+ - `login [apikey]`: store an API key locally.
29
+ - `doctor`: inspect installation health and gather troubleshooting details.
30
+ - `probe`: test whether the update endpoint would deliver an update.
31
+
32
+ ### App-level operations
33
+
34
+ - `app add [appId]`: create an app in Capgo Cloud.
35
+ - `app list`: list apps under the current account.
36
+ - `app delete [appId]`: remove an app.
37
+ - `app set [appId]`: update app settings such as name, icon, retention, and metadata exposure.
38
+ - `app setting [path]`: update Capacitor config values programmatically.
39
+ - `app debug [appId]`: listen for live-update debug events, optionally for one device.
40
+
41
+ ### Docs and agent integrations
42
+
43
+ - `mcp`: start the Capgo MCP server for AI-agent integrations.
44
+
45
+ ### GitHub support commands
46
+
47
+ - `star [repository]`: star one Capgo repository, defaulting to `capacitor-updater`.
48
+ - `star-all [repositories...]`: star all Capgo repositories matching the default filter, with delay and concurrency controls. The default set includes `capacitor-*` repositories plus `Cap-go/CLI`, `Cap-go/capgo`, and `Cap-go/capgo-skills`.
49
+
50
+ ## Related skills
51
+
52
+ ### `release-management`
53
+
54
+ Load `skills/release-management/SKILL.md` when working with:
55
+
56
+ - `bundle upload`, `bundle list`, `bundle delete`, `bundle cleanup`
57
+ - `bundle compatibility`, `bundle releaseType`, `bundle zip`, `bundle encrypt`, `bundle decrypt`
58
+ - `channel add`, `channel list`, `channel delete`, `channel set`, `channel currentBundle`
59
+ - `key save`, `key create`, `key delete_old`
60
+
61
+ ### `native-builds`
62
+
63
+ Load `skills/native-builds/SKILL.md` when working with:
64
+
65
+ - `build request`
66
+ - `build credentials save`
67
+ - `build credentials list`
68
+ - `build credentials clear`
69
+ - `build credentials update`
70
+ - `build credentials migrate`
71
+
72
+ ### `organization-management`
73
+
74
+ Load `skills/organization-management/SKILL.md` when working with:
75
+
76
+ - `account id`
77
+ - `organization list`, `organization add`, `organization members`, `organization set`, `organization delete`
78
+ - deprecated `organisation` aliases
79
+
80
+ ## Common command examples
81
+
82
+ ```bash
83
+ npx @capgo/cli@latest init YOUR_API_KEY com.example.app
84
+ npx @capgo/cli@latest login YOUR_API_KEY
85
+ npx @capgo/cli@latest doctor
86
+ npx @capgo/cli@latest probe --platform ios
87
+ npx @capgo/cli@latest app add com.example.app --name "My App"
88
+ npx @capgo/cli@latest star-all
89
+ ```