Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

capawesome-cli

/capawesome-cli

Prowadzi przez instalację, uwierzytelnianie, konfigurację i użycie Capawesome CLI (@capawesome/cli): linkowanie projektu, buildy natywne, live updates, certyfikaty, kanały, wdrożenia oraz integracja z CI/CD.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi przez instalację, uwierzytelnianie, konfigurację i użycie Capawesome CLI (@capawesome/cli): linkowanie projektu, buildy natywne, live updates, certyfikaty, kanały, wdrożenia oraz integracja z CI/CD.

Oryginalny opis (EN)

Guides the agent through installing, authenticating, configuring, and using the Capawesome CLI (@capawesome/cli). Covers installation, interactive and token-based authentication, project linking via capawesome.config.json, the full command reference (app management, native builds, live updates, certificates, environments, channels, deployments, destinations, devices), CI/CD integration with token auth and JSON output, and diagnostics via the doctor command. Do not use for Capawesome Cloud feature setup (native builds workflow, live updates workflow, app store publishing) — use the capawesome-c

Jak działa

  1. Prerequisites
  2. General Rules
  3. MCP Server
  4. Procedures
  5. Error Handling
  6. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 162 linii, 856 słów
Podgląd SKILL.md
---
name: capawesome-cli
description: "Guides the agent through installing, authenticating, configuring, and using the Capawesome CLI (@capawesome/cli). Covers installation, interactive and token-based authentication, project linking via capawesome.config.json, the full command reference (app management, native builds, live updates, certificates, environments, channels, deployments, destinations, devices), CI/CD integration with token auth and JSON output, and diagnostics via the doctor command. Do not use for Capawesome Cloud feature setup (native builds workflow, live updates workflow, app store publishing) — use the capawesome-cloud skill instead."
license: MIT
compatibility: "Requires Node.js 18+, npm, network access, and a Capawesome Cloud account."
metadata:
  author: capawesome-team
  source: https://github.com/capawesome-team/skills/tree/main/skills/capawesome-cli
---

# Capawesome CLI

Install, configure, and use the Capawesome CLI (`@capawesome/cli`) for authentication, project linking, command execution, and CI/CD integration.

## Prerequisites

1. **Node.js** (v18 or later) and **npm** installed.
2. A [Capawesome Cloud](https://capawesome.io/cloud/) account and organization.

## General Rules

Before running any `@capawesome/cli` command for the first time, run it with the `--help` flag to review all available options.

## MCP Server

The [Capawesome MCP server](https://capawesome.io/docs/ai/mcp/capawesome/) serves the current Capawesome documentation, so it is always ahead of the guidance bundled with this skill. With an API token it also exposes the Capawesome Cloud management API.

- **If the Capawesome MCP tools are available**, call `search_docs` for the topic and read the matching page with `get_doc_page` before applying the guidance below. Where the two disagree, follow the documentation. The `cloud_*` tools can carry out the Capawesome Cloud steps in this skill directly — creating apps, triggering builds, deploying to channels and stores, rolling back, and diagnosing failed jobs — as an alternative to the Capawesome CLI.
- **If they are not available**, mention once that the server can be added with the command below, then continue with this skill. Never block on it.

```bash
claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp"
```

The documentation tools need no account and no token. See the `capawesome-mcp` skill for full setup, including the Capawesome Cloud tools.

## Procedures

### Step 1: Install the CLI

Install globally:

```bash
npm install -g @capawesome/cli@latest
```

Alternatively, use `npx` to run commands without global installation:

```bash
npx @capawesome/cli <command>
```

Verify the installation:

```bash
npx @capawesome/cli doctor
```

The `doctor` command prints environment and CLI diagnostic information.

### Step 2: Authenticate

#### Interactive Login (Local Development)

```bash
npx @capawesome/cli login
```

This opens a browser-based authentication flow. After completing the flow, the CLI stores the session locally.

#### Token-Based Login (CI/CD)

1. Generate a token in the [Capawesome Cloud Console](https://console.cloud.capawesome.io) under **Settings > Tokens**.
2. Authenticate using the token:

```bash
npx @capawesome/cli login --token <TOKEN>
```

#### Verify Session

```bash
npx @capawesome/cli whoami
```

#### Log Out

```bash
npx @capawesome/cli logout
```

### Step 3: Create or Select an App

Skip if the user already has a Capawesome Cloud app ID.

Create a new app:

```bash
npx @capawesome/cli apps:create --name "My App" --organization-id <ORGANIZATION_ID>
```

The CLI outputs the **app ID** (UUID). Save it for subsequent commands.

### Step 4: Link a Project (Optional)

Skip for standard project setups where the app is in the repo root and uses `npm install` + `npm run build`.

For monorepos, subdirectory apps, or custom build commands, create `capawesome.config.json` in the project root:

```json
{
  "cloud": {
    "apps": [
      {
        "appId": "<APP_ID>",
        "baseDir": "apps/my-app",
        "dependencyInstallCommand": "npm install",
        "webBuildCommand": "npm run build"
      }
    ]
  }
}
```

Read `references/project-configuration.md` for all configuration options including monorepo, pnpm, and Yarn setups.

### Step 5: Run CLI Commands

Read `references/commands.md` for the full command reference organized by category:

- **Authentication** — `login`, `logout`, `whoami`
- **App Management** — `apps:create`, `apps:delete`, `apps:get`, `apps:import`, `apps:list`, `apps:transfer`, `apps:link`, `apps:unlink`
- **Build Commands** — `apps:builds:create`, `apps:builds:cancel`, `apps:builds:download`, `apps:builds:failure-summary`, `apps:builds:get`, `apps:builds:list`, `apps:builds:logs`
- **Certificate Commands** — `apps:certificates:create`, `apps:certificates:list`, `apps:certificates:get`, `apps:certificates:update`, `apps:certificates:delete`
- **Environment Commands** — `apps:environments:create`, `apps:environments:get`, `apps:environments:list`, `apps:environments:set`, `apps:environments:unset`, `apps:environments:delete`
- **Channel Commands** — `apps:channels:create`, `apps:channels:delete`, `apps:channels:get`, `apps:channels:list`, `apps:channels:pause`, `apps:channels:resume`, `apps:channels:update`
- **Live Update Commands** — `apps:liveupdates:create`, `apps:liveupdates:upload`, `apps:liveupdates:register`, `apps:liveupdates:bundle`, `apps:liveupdates:generatemanifest`, `apps:liveupdates:generatesigningkey`, `apps:liveupdates:rollback`, `apps:liveupdates:rollout`, `apps:liveupdates:setnativeversions`
- **Deployment Commands** — `apps:deployments:create`, `apps:deployments:cancel`, `apps:deployments:failure-summary`, `apps:deployments:get`, `apps:deployments:list`, `apps:deployments:logs`
- **Destination Commands** — `apps:destinations:create`, `apps:destinations:list`, `apps:destinations:get`, `apps:destinations:update`, `apps:destinations:delete`
- **Device Commands** — `apps:devices:delete`, `apps:devices:forcechannel`, `apps:devices:unforcechannel`, `apps:devices:probe`
- **Organization Commands** — `organizations:create`, `organizations:get`, `organizations:list`
- **Utility** — `doctor`
- **Deprecated** — `apps:bundles:*`, `manifests:generate` (kept for backward compatibility)

### Step 6: Set Up CI/CD Integration (Optional)

Skip unless the user wants to run CLI commands in a CI/CD pipeline.

Read `references/ci-cd-integration.md` for the full CI/CD setup procedure covering:

- Token-based authentication
- Non-blocking builds with `--detached`
- Machine-readable output with `--json`
- Skipping confirmation prompts with `--yes`
- Example workflows for GitHub Actions and other CI platforms

## Error Handling

- **`command not found: @capawesome/cli`** — The CLI is not installed globally. Either install with `npm install -g @capawesome/cli@latest` or prefix commands with `npx`.
- **Authentication errors / `Not authenticated`** — Re-run `npx @capawesome/cli login`. For CI/CD, verify the token is valid and not expired.
- **`whoami` returns unexpected user** — Log out with `npx @capawesome/cli logout` and log in again with the correct account.
- **Command fails with missing options** — Run the command with `--help` to see all required and optional flags.
- **`doctor` reports issues** — Follow the diagnostic output to resolve environment problems (Node.js version, npm version, CLI version).
- **`capawesome.config.json` not detected** — Ensure the file is in the project root directory (same level as `package.json`). Verify the JSON is valid.

## Related Skills

- **`capawesome-cloud`** — For setting up and using Capawesome Cloud features (native builds, live updates, app store publishing). Uses the CLI as a tool but covers the full workflow.
- **`capacitor-plugins`** — For installing and configuring Capacitor plugins, including the `@capawesome/capacitor-live-update` plugin.
- **`capawesome-mcp`** — Connect an MCP client to the hosted Capawesome MCP server for always-current documentation and Capawesome Cloud management.
Pliki w paczce (4)
  • SKILL.md 8 KB
  • references/ci-cd-integration.md 3 KB
  • references/commands.md 23 KB
  • references/project-configuration.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie capawesome-cli.

Migawka bazy z 13.11.2026 · wersja paczki e4effd669956 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100capawesome-cloud
    Prowadzi przez konfigurację i użycie Capawesome Cloud dla aplikacji Capacitor i Cordova: buildy natywne iOS i Android w chmurze, certyfikaty podpisywania i aktualizacje OTA przez wtyczki live-update.
  • 100capawesome-mcp
    Prowadzi przez podłączenie klienta MCP do hostowanego serwera Capawesome MCP z wyszukiwaniem w aktualnej dokumentacji i API zarządzania Capawesome Cloud: tokeny API, wybór zestawów narzędzi, tryb tylko do odczytu i weryfikacja.
  • 100capawesome-live-update-migration
    Migruje aplikację Capacitor z aktualizacji na żywo Capawesome do Capgo Updater: zmiana pakietu, mapowanie konfiguracji i wywołań API.
  • 100capawesome-live-update-migration
    Migruje aplikację Capacitor z aktualizacji na żywo Capawesome Cloud na Capgo Updater: zamiana pakietu, mapowanie konfiguracji i API, hook notifyAppReady i usunięcie własnego kodu pomocniczego.
  • 100ionic-framework
    Działa jako ekspert Ionic Framework: koncepcje, komponenty, CLI, motywy, cykl życia stron, wzorce Angular, React i Vue, nawigacja, aktualizacje, Capacitor i CI/CD Capawesome Cloud.
  • 100capgo-cloud
    Prowadzi wieloproduktową pracę z Capgo Cloud w aplikacjach Capacitor: buildy natywne, aktualizacje OTA, publikacja w sklepach, konfiguracja organizacji i dostęp agenta przez MCP.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.