Skip to main content
Compose is currently in private beta and access is invite-only. Goldsky Enterprise customers can contact their Account Manager for expedited early access. The following commands will not work even if you have the Goldsky CLI installed unless you have been explicitly whitelisted by the Goldsky team.

1. Install the Compose CLI Extension

If you already have the Goldsky CLI installed, you’ll just need to install the Compose extension.
goldsky compose install
If you don’t already have the Goldsky CLI installed you’ll need to start by installing that, then run the above command. For macOS/Linux:
curl https://goldsky.com | sh
For Windows:
npm install -g @goldskycom/cli
Windows users need to have Node.js and npm installed first. Download from nodejs.org if not already installed.

2. Create your app

Create a new Compose project with a working Bitcoin oracle example:
goldsky compose init
This command will:
  • Prompt you for a project name and create the app under that directory
  • Scaffold a complete example app with a working Bitcoin oracle
    demo-app/
      compose.yaml              # the app manifest
      tsconfig.json             # TypeScript configuration
      .gitignore
      src/
        tasks/
          bitcoin-oracle.ts     # example task
        lib/
          utils.ts              # shared utilities
    

3. Start the app locally

Start the app:
goldsky compose start
Your Compose application is now running! The server will start and begin accepting requests on port 4000. You can test triggering a task like so:
goldsky compose callTask bitcoin_oracle '{}'

Updating the CLI

To update to the latest version, run the update command:
goldsky compose update