Installation

This chapter covers installing and verifying Shape locally.

Prerequisites

• Rust toolchain (Rust 1.82+, Cargo included)

If Rust is not installed:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Install from crates.io

The recommended setup is to install both the CLI and the LSP:

cargo install shape-cli
cargo install shape-lsp

This installs:

• shape - CLI, runner, and REPL entrypoint
• shape-lsp - language server for editor integration

Verify both binaries:

shape --version
shape-lsp --version

Editor integration

The LSP is picked up automatically by editors with Shape support:

• VS Code — install the Shape Language extension. It auto-detects shape-lsp on your PATH and offers to install it if missing.
• Neovim — see Editor Setup (Neovim)
• Mason (Neovim) — :MasonInstall shape-lsp (pending registry PR)

Install from source

For development or the latest unreleased features:

git clone https://github.com/shape-lang/shape
cd shape
cargo build --workspace --release

The binary will be at target/release/shape.

The LSP binary will be at target/release/shape-lsp.

Extensions

Shape extensions add language runtime integrations (Python, TypeScript, etc.). Install them with shape ext:

shape ext install python
shape ext install typescript

This downloads the extension crate from crates.io, compiles it for your platform, and installs the shared library to ~/.shape/extensions/. Extensions are automatically detected by both the CLI and LSP — no additional configuration needed.

Manage installed extensions:

shape ext list              # show installed and available extensions
shape ext remove python     # uninstall an extension

Quick test

Create hello.shape:

fn main() {
  print("hello from shape")
}

main()

Run it:

shape run hello.shape

Expected output:

hello from shape

Or test an expression directly:

let x = 10
let y = 20
print(x + y)  // 30

Next Steps

Continue with Your First Program.