Install

The Visual Studio Code extension includes the Pebble compiler, but it’s highly recommended to also install the CLI for running swamp commands from the terminal.

Note: To run compiled Pebble programs, you’ll also need an engine, e.g. moss.

Visual Studio Code Extension

The VS Code extension includes the Pebble syntax highlighting.

To install:

  1. Open VS Code
  2. Press Cmd+Shift+X (macOS) or Ctrl+Shift+X (Windows/Linux) to open Extensions
  3. Search for “Pebble Basic”
  4. Click Install on “Pebble Basic” by swamp

Or install directly from the marketplace.

Brew

on macOS and Linux please use Brew to get Pebble:

brew tap pebble-lang/tap
brew install pebble

(tap only needs to be added once)

Scoop

on Windows use Scoop to get Pebble:

scoop bucket add pebble-lang https://github.com/pebble-lang/scoop-bucket
scoop install pebble

(bucket only needs to be added once)

Verify Installation

Check that pebble is installed correctly:

peb

It should output the version number and help information. At this time it should be at least v0.0.1

Getting Started

Once installed, create a simple program in main.peb:

for i = 1 to 3
    print "hello, world"
end

Then compile to create a moss cart:

peb build main.peb
moss out/main.moss

Next Steps

Since Pebble compiles to moss carts, you can currently only use it in:

  • Moss32 - a retro fantasy console.

Manual installation requires setting up PATH and dealing with OS-specific permissions. Use the package managers above instead.

If you still need it: download the peb executable from releases.