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 makes the app under that directory
  • Scaffold out a complete example app
    demo-app/
    	compose.yaml # the app manifest, containing the configuration
    	tasks/ # each file defines an executable task that can run in a sandbox
    		task_a.ts 
    		task_b.ts
    	.gitignore
    

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